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This publication is intended for system programmers, 
application programmers, aad terminal users. It describes 
bow to as; tae CSS EDIT program to create or modify files at 
tbe terminal. 

It is divided iato torse sections, contains two appendices 
aid a glossary of terms. 

Tbe Introducti on iescrmes tha facilities of tae editor and 
bow it operates. Subcommand ana macro conventions are also 
included. 

Tbe section EDIT Siocommands and Macros discusses each 
subcommand aad macro in detail. 

giam plas, aow to Use tbe Edit or will contain examples of 
creating and modifying files using the editor. 

Appendix A^, Summar y of EDIT Subcommands . lists tbe 
subcommands with tneir parameters. 

Appendix a._, E ditor Mess age s, lists tae editor messages and 
contains a orief description for each message. 

The Glos sar y contains some of tbe terms that are used in 
this publication. 

Other related publications tor the effective use of this 
manual are: 
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33057 

3BIBT30 
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3 3*59 

2RIMT20 

33*53 
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The C33 Biitor is a facility that allows you to: 

• Create, fro* a terminal, sequential riles containing 
either fixer or variable length records 

» with certain niatypes, use the standard default values 
for record length, record format, tab settings, 
serialization, imemode, and lowercase to uppercase 
translation 

® Add, delete, and/or change any part of a file 

® Sore one or sore lines m a file fro* one place to 

another 

• Sxtract ali or part of a rile and sake it a new file or 
iabed it into another file 

« Search and change a file through context-direction, 
line displacesent, and line nuaber 

• Becaire prompting with line numbers if desired 

• Display at a terminal all or part of a file 

• (Jse the CSS £XZC interpreter to utilize user written 

aacros 

Tie editor operates in either one of two nodes, IHPUT and 
£Dir. Tou control the sode m which the editor operates by 
the instructions that you enter at the tersmal. 

Associated with eacn file is a line pointer. The line 
pointer points to taa line or record of the rile tnat you 
are processing. Naan m IB PUT soae, the editor can assign a 
nusbec to tne line of data that you are eutering. Tne record 
uuaber is increaented for each line of data. Thus, when in 
ZD IT sode, you can refer to a line of data by its number; 
you can also refer to ail or part of a record by indicating 
tae specific contents of the record to be processed. The 
latter method of processing can be especially useful when it 
is necessary to locata/chaage a specific word or pnrase 
within the file Decause it relieves you of the tas* of 
seeping trae/t of record numbers and displacements. 
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3 0373 

ERisrao 
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30381 

EBisrao 

00032 

ERisrao 

00081 
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CO 38 7 

EBisrao 

03389 
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30093 
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00092 
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"3095 

EBisrao 
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30101 
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30102 
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03134 
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33135 

EBisrao 
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30103 

ERisrao 

"C109 

ERisrao 

03113 

EBisrao 

3 3111 

ERisrao 

30112 

ERisrao 

03113 

EBisrao 

03115 

ERisrao 

33115 

ERisrao 

"3117 


2£2airiOi 21 the idiur 


Editing is performed ipoa a copy cr tae file tail is xl laxa 
storije. Inis dpproar:i provides tor rapia movement ooth 
focvard aad backyard tarouga tne rile. It does, aoyever, 
limit the tiles to be edited to those that can oe »tolly 
cottaiaed aitnin the availaole virtual storage. It is 
possible to perform eiitiag operatioas upon larger tiles by 
splitting the tile into ssaller files that can be handled by 
the editor. 


LIME ROISTER 


Associated vita eaca rile is a line pointer. Tne line 
pointer identities the line m the file that is considered 
to-be the current line. The current line is derined as the 
line that is being created or edited in the rile. 

fsrioas EDIT subcommands ana aacros are provided tor aoving 
the current line pointer. Ton can aove the line pointer to: 

® A specific record (indicated by its record number) 

-® A record specified by its relative dispiaceaeat (in 

naaber of records) forvard cr oackvard froa the current 
position of the pointer 

• A record containing a specified string of characters or 
having a specified label. 

Ime latter ability to search for strings alloys you to be 
concerned vita only tne textual context, relieving you of 
ceepiog track of record numbers and counts of inserted and 
deleted records. 

mhen you change tne aode froa INPOT to EDIT, the pointer is 
positioned to the last line enterea froa the terminal, froa 
BOH to ISPOT, the poioter is positioned such that the lines 
being entered follov the last line edited. 

After you issue the EDIT command and enter EDIT mode, the 
pointer is positioned at a null line that the editor places 
in front of the first line of the file. If, during the 
processing of tae file, a UP or an OP subcommand is issued, 
the pointer is positional at tnis null line. The null line 
is not yritten onto direct access storage, nor is it 
displayed at the terminal. Ir you issue a TXPE subcommand 
mhen the pointer is positioned at tae null line, a null line 
yith a carriage return is type!. 
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ssrsosa 

2HINTRJ 

o = :s no 

1 ~t I4 ? 5. J 
ORISORO 


samrao 


sRisrao 
2 am rao 
sbihtro 
2Rinrao 
sristbo 
^E ispao 
23IHTRO 

samrao 


Eamrao 


SEisrao 

erihtbo 

aamrao 

2 Rmrao 

EEinrao 

samrao 

3EINTBO 

2RIHT 30 
jBitirao 
2RIHTR0 
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3BIBT80 


2Kisrao 

2HISP50 

EBINTko 

2BIHT30 

lamrso 

sbistsd 


3BiNrao 


In.1 CtiSF ID EE IIAL 


'3113 

':ii9 

*0120 
': 121 
' ' 122 


If you eater j nuii iiae voile it INPUT aode, tne mode 
caanges zo EDIT. If you enter a tuii line wmle in EDIT 
aode, tae confiramg leese^e EDIT: is printea. To cnange 
froa EDI I aoie to I.»?jT xoue, issue toe IJJPuI subcoaaand 
without my r araaeter. 


''*125 


ispar sods 


?: 12 s 

'3127 
30129 
30131 
00131 
00132 
00133 
*01 3ft 


Tae IHPUr aoie is inuicated by the aessage ISPOI:, a 
carriage return, and tae unlocking ot the xeyboara. You can 
then type successive lines of input to the file. To insert a 
slant line in a file, type at least one space and tnen press 
tae carnage return cey. A null line (that is, a carriage 
return with no prior blants or characters) entered shea in 
IMPDT aoie does not add a slant line to the file, it changes 
the sode to 2DII 


001 37 2DII SODS 


fae SDIT aoie is indicate! oy tne aessage EDIT:, a carriage 
return, and tne unlocting of the teyboard. You can then aate 
changes to a file by issuing EDIT subcoaaands and aacros. 
All changes to tae file becoae effective iaaediately in aain 
storage, thus, allowing subseguent modifications to be aade 
to a file. Tne caange^ file is written onto direct access 
storage vita the FILS and SAVE ccaaands. 

03143 If you issue a jail suocoaaani, tnen the caanges are ignored 
00149 and the original rue is tept as it existed before any 
00153 changes were jade. If the file was newly created, it is not 
00151 written onto iisx. 


00139 
0 0140 
00141 
00142 
'0143 
0 0144 
00145 


00153 

EDIT Responses 

0 0154 

ferification, 

00155 

aocwal respons 

'0155 

that you nave 

00157 

taraiaal. If 

'0153 

are printed. 

3159 

aust issue tne 


invoxei oy tne 9EBIFY subcoaaand, is the 
aoae oi tne editor. It causes each line 
chaagai or found to be displayed at your 
you turn verify off, noraai editor messages 
owever, to display a line at a terainal, you 
TYPE cojaand. 


00162 


OPESAflOEAL CiAhAETSSISriCi 
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2218733 

2BINT30 
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ERINT2U 
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ERINTR3 


S&INT30 


EINTRU 
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BINT30 
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8INT30 
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FINT20 
BINTRO 
Biirao 
2BIRTR J 
2BINT20 


3BiMrao 


3818730 
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3HIMT2U 

ERINTHO 

E2INT80 

ER£^r20 


3RINT80 

3BIN"30 
TRTH 73 3 
-i BIN PRO 
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1 a5 


iAIN STO^AoI SUEZ DEO 


*:-i63 
33167 
33163 
: }io? 
3 217 3 
*3171 
"3172 
3 3173 


££ tae available main storage becomes lull, tae editor 
issues the massage A7AILABLE STORAGE IS NOB BOLL. It is 
then possible to and new lines only it existing ones are 
deleted first. It you atteapt to insert a line (or a file) 
when there is no room, tae editor responds NO BOOB, ensures 
that SOU mode is set, deletes any stactea lines and issues 
the aessage STACKED LINES CLEARED m order to avoid aultiple 
error messages. 


33173 FULL DISK CONDITION 


la executing a FILE or SA7E subcommand, the editor writes a 
temporary wort-file, railed CdSUIl, alters tne name to that 
required, aad erases tae old copy of the file, if it exists. 
During this process, if the output disx necomes full, CBS 
types the aessage. **x-DISK (zzx) IS FULL **». Tne editor 
laaediately erases the worx-file (which will ae mcoaplete) , 
and issues the aessage SET NSw FILZMOCE, OR ENTER CSS SUBSET 
AND BAKE BORE RUOf. Thus, the FILE or SAVE suocoaaand aave 
no overall effect except to produce the aessages. A similar 
response follows an atteapt to create aore than the maxiaua 
number of CBS files. 


"3193 TUP AND BND-DF-PILL CONDITIONS' 


"3173 
33179 
7 " 13 2 
23133 
03131 
r 3132 
'0133 
3 3134 
03135 
3 3183 
0H87 


30191 At the top of every file taere is a aull line. It is not a 
"3192 part of the file, is present only during eaiting, and cannot 
*"194 be modified. If priateu, it appears as a blaais line. Inere 
33195 is also an Eni-Jf-Jile (EOF) condition. It occurs if you 
30195 atteapt to go oeyond tne last line of tae iij.e. Tae aessage 
3 3197 E3P: is printed. 

*3193 EDIT subcoaianis, waen issued at tae top of tae fixe or at 
33203 SUP behave as follows: 


33233 


Sgbcoiaaad 


E rfact at the top of t ae file. 


" *2*5 
""235 
", 2 3 7 
: 32 33 


ALTER, CHANCE 


If tae subcommand applies to the top line 
only, tae aessage NOT FJUNL is issuea; to 
oora t-aan one line, the nuaDer is decreaentea 
oy one oefore proceeding to tae next line. 


ID 



zaiNrao ^ :• 2 13 
’fiisrao ? 5212 


d2Let3 


esixtso ^''214 setfile 

Eaisrao :5215 

2RIST33 35216 

3BI»rH0 3 5213 OOili, NEXT 

ERisrao 03221 tips, stack 

3RIBT30 33223 OVERLAY 

EHINT30 33224 

ERISTSO 33225 

EBisrao 33226 

ERIHTaO ‘'3223 REPLACE 

281X1*30 03229 

EBisrao *3232 top, 3 ? 


EBIBT10 

00235 

Sjbcoaaand 

SBisrao 

30233 

ALTER, CHARGE, 

3RISTR0 

03243 

FIND, LOCATE 

3HIST30 

03243 


38IHT30 

0 3241 


sfiisrao 

00243 

33TT05 

aHisrao 

30245 


2EXHT30 

00243 

DELETE, DOSS, 

BBisrao 

"'0253 

SBIT, OVERLAY 

28IST30 

00251 

STACK 

3RINT30 

0 0253 


BBisrao 

3 3255 

GETFIL 2 

2BI8T30 

0 3255 


2BIHT30 

0 3257 


sarsrao 

0 3258 


3Hi»rao 

03261 

TYPE 

3RIHT80 

00264 

IB PUT 

2FIHT80 

30265 

3EPLACE 

SaiSTBO 

0025 7 


2RTSTR0 

r 026 9 

.U? - .- 

3FIST3D 

30273 


2RIST30 

”•2 71 
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DELETE is processed as if it were successful, 
but the top line is not deleted. 

The new lines obtained are insertea in the 
file and the last line that is inserted 
becoaes the current line. 


The top line is processed as a blanx line. 

If 07EELAT applies only tc the top line, it 
has no effect; to sore than one line, the 
nuaber is decreaentea before proceeding to 
the next line. 

The nan line is inserted and becoaes the 
current line. 

Have no effect. 


Effect w hen the EOF Condition exists 


Tne EOF condition is cleared, and the 
subcoaaand is processed as if it were issued 
a the top of the file. 

The EOF condition is cleared, and the last 
line of the file becoaes the current line. 


If verification is off, the subcoaaand is 
ignore!; if on, the aessage EOF: is issued. 

The EOF condition is cleared, the new lines 
obtained are inserted after the last line of 
the file, and the last line obtained becoaes 
the current line. 

Produces the aessage EOF;. 


The EOF condition is cleared, and the new 
level( 5 ) axe inserted after the last line. 

OP is processed as it the current line was 
null line following the last line of the 
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3BBACR0 
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3RSAC33 

00057 

2RSACR0 
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SRSACBO 

00061 
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00062 
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effaced 

00^65 
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3 005 5 
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2 R a a c a o 
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2MA:3D 

00069 
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Tae conventions used in :ais publication to illustrate 20IT 
subcommands and macros are as follows: 

1* Uppercase letters and punctuation marks (except as 

iesccioed in items 3 through 6) represent information 
tnat must be coded exactly as shown. 

2. Lowercase letters and terms represent information that 
you must suppiy. 

3. Information contained witnic brackets £ j represents an 
option tnat you can include or omit, depending on the 
requirements of me program. 

4. Options contained within braces ( ) represent 

alternatives, one of wnich must be chosen. 

3. An ellipsis (a series of three periods) indicates that 

a variable number of items may be included. 

3. Some subcommands may be specified by entering the 

subcommand or any portion of the subcommand from it*s 

minimum acceptaole truncation to the complete 
subcommand. For example, the minimum truncation for 
ALTER is AL; tttUS, AL, ALT, ALTS, or ALTEB will invoke 
the ALTEB subcoxmand. Those subcommands that can be 
truncated are contained within braces with the 

subcommand separated from its minimum truncation by a 
vertical bar (logical OR). 

7. Jnderlined elements represent an assumed option in the 
event a parameter is omitted. 

&» When options appear in a string, they are separated by 
a vertical bar (logical OR) . 

For all entries tor the filename, filetype and fileaode 
options, you must adhere to the conventions for tnese 
options as described in the discussion of the CBS File 
Sanagament System in Va/370 Command Language Dser *s Guid e. 
Slnn-nnnn. 


editor saaoa pejcsoohes 


Ail suocoaaands aad macros are fully checxed for validity. 
A suocommand or macro waich is invalid is not processed, the 
count for the REPEAT subcommand is reset to 1, and the 
message -* or 2EDIT: ... is issued. If a valid sabcommabdeor 
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?eha23g 

erhacbg 

beha:-?) 

BHMACRO 

EHHACRO 

3B3ACBO 

2BHA320 

ERHA330 

EBHAC30 

ERSACBO 

2SSAC33 

erhacbo 

3RHAC30 

ERHAC33 

SBHACBO 

SBHACBO 


3RHA2RO 


3BHACBO 

zbhairo 

SBHACBO 

EHHACBD 

SBHACBO 

SBHACBO 

SBHACBO 

SBHACBO 

3RHAC30 

SBHACBO 

SBHACBO 

SBHACBO 

SBHACBO 

SRHACBO 

SBHACBO 

SBHACBO 

SBHACBO 

SRHACBO 

SBHACBO 

SBHACBO 

SBHACBO 

SBHACBO 

SRHACBO 

SRHA3RO 

SBHACBO 

SRHACBO 


2'2 7 3 macro tails during erecutioa, a tore detailed message is 

CO'71 typai. 


: ? * 73 

*C73 
20374 
20075 
0 3276 
30377 
33373 
C 3073 
C 3 0 8 3 
3 3381 


Also, iurmg a t=rauai session, tne editor communicates 
status information pertinent tc current reguests. These 
messages do not nave an associated error code and are not 
iadxcative of a condition serious enough to reguire 
termination of editor processing. The messages are issued 
primarily to inform you of possibly unexpected circumstances 
in suncomaanu execution so, if necessary, you may be more 
fully able to contend yitn the ccndition. Some messages are 
simple of an informative nature or only act as a reassurance 
of continued editor operation. 


33332 
03383 
30035 
C 3086 


For your convenience, a complete list of responses and 
informative messages is listed in Appendix B. For a more 
complete description of the messages, see ?H/373 System 
Hessages, ccna-nnan. 


'’023 9 


SITES OS SBITIM3 EDIT HACaOS 


03393 
3 3091 
3 3092 
30093 
3309 4 


You may write your own EDIT macros. A good knowledge of the 
CHS EXEC language is reguired. It is your responsibility to 
insure that any EDIT macro that you write checks the 
validity of its parameters and types an error aessage if 
necessary. 


30C95 
37396 
3 3397 
33093 
33099 
0)103 
33102 


Parameters of a macro reguest must be separated from the 
macro name, and from each other, by at least one blank. 
Single and double guote marks cannot be entered as 
parameters, since they have a special meaning to the EXEC 
interpreter. Parameters passed tc an EDIT macro are subject 
to tne same rules as any other EXEC file (that is, the 
length of a parameter must be less than nine bytes). 


2)133 
2)139 
33135 
03135 
C 310 7 
00108 


If an EDIT macro is issued, and the EDIT macro file does 
not exist, the editor issues the message ?£DIT... . If it 
is used incorrectly, the editor types a message, and the 
macro is ignored. If an EDIT macro reguest is assigned to X 
or I, it is an error to issued that X or ¥ reguest with a 
numerical parameter other than 0 or 1. 


33139 Some EDIT macros need to monopolize the CHS stacking 
0)113 facilities during their execution. If stacked lines exist 
22111 when one of these macros is invoked, the stacked lines are 
23112 deleted and tne editor issues tne aessage STACKED LLHZS 
■'■'113 CLEARED BT macro name. For example, this occurs if the CHS 
33113 linend charier 2 r nas oeen usea to stack additional reguests 
''Dill after the macro is issued. Do not interrupt the execution 
33115 of an EDIT macro via attention key. 



M M M W ft| 


IdS. CGKFIDEITIAL. 


2=SAC33 

: 0 1 1 7 

ER5AC33 

3 0113 

Ex’! .1033 

''■*113 

EFFAC’D 

*312) 

2BfAC33 

: :i22 


An EDIT lacro tnat uses FIFO stacking should normally ensure 
that the stacx is initially clear. If the operation of an 
EDIT lacro is completed vitn an error, the editor clears any 
stacx lines ana issues tne message STACKED LIKES CLEARED. 
Thus, the macro has no effect on tne editor or its contents. 


BfACBO C 312 3 lenerally, EDIT macros should operate with VBRIFI OFF in 
B3AC30 ?)124 order to avoid excessive typing fcy the editor. This can he 
EHAC33 ?1125 accomplished vitnout losing your setting by stacking 
«flC33 O') 126 PBES23VE and VERIFY OFF for execution first, and BESTOfiE for 
B33C3.fi *0001 execution last. 
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3BSB30H1 oooos 


2D 11 3J3C;Jdd ASD3 isj 3A-303 


5BSB30B1 00013 


A3A I M SUBC OBBAHD 


3533^031 03C19 
EBSBC3B1 33023 
ERSBTDSI *? >C 21 


rae AGAIN suocoaiaad aiiovs you to stac*. (LIFO) the last 
3011 subcoaxaad except A3A IS or a question aark and then 
execute stacxea sabcoxxaais. 


2BS320B1 j K 23 
3B333Dai 00024 
EBSBC0B1 00025 
ERSBCOBl 00025 
ERSBCHBI "'0027 


i - ------ 1 

I Subcoaaand | Paraaeter I 

,-1--i 

t AGAIN | [sjDCoaaaad] | 

«_>_ ___i 


EBSBCOB1 00031 
2RSS30!!1 00033 


subcoxaand 

Specif; aay EDIT suocoaaand. 


2BS3C3N1 03033 
23SBC3B1 03035 
2BS33731 00037 
2BSBC331 03333 


If an invalid £DII subcoaaand is specified and it is aot 
executed, the stacked subcoaaand is deleted. Thus, the 
invalid subcoaaand has no overall effect except to type an 
error aessage. 


2B5B2331 30040 AGAIN can also be used to repeat a valid EDIT subcoaaand or, 

2RSBC031 03041 an soae cases, to correct aa invalid one. For instance, 

ZfiSBGOHI 03041 consider a user, vithout verification, aistakenly thinks he 

ERSBJDHI 00043 is INPUT node: 

2R3BC3S1 33045 The self-abnegation aust be coaplete. Froa 

2HSB33.H 0”)04 7 r SDIT:THE SELF 

2RSBCDB1 -0043 again i 

2BSB27H1 33349 the point of vie* of Guataaa, the dread of 

ERS3C3B1 03353 death, that greei for an endless continuation 

2B3B3331 30052 


EBSBCOB1 30053 


4iXEa suac oaaA Np 


2BS333a 1 0006) The ALTER subcoaaand illows you to search ail or any part of 
2BSBcbal 33361 a fila for a character or a byte of data to alter that 
2RSB0JS1 33352 character vita anotner character or byte of data. 


3FS3JON1 ■''06 + 
2P533311 :) f '65 
33333dal 3 3C65 

2BSB33H1 09067 

2?5t>3ial ■'■'363 


1 — — 

I Sab^oaadni | 

I pardietjrs I 

1 i 

| (ALTSR | AL) | 

i_ 

i {option 1 j {opt iDD2} £ Jl n | ♦ £1|G|«]] j 
_ ... ._j 
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isa -COHE-iD.£ariAL 


3BSBC0H1 

3HSB-DS1 

3BS3C0M1 

335323S1 

2R33C0M1 

BBSBC0B1 

SRS330S1 

3RSBC0H1 

3BSBC0M1 

3BSbcomi 

2RSBC081 

2BSBC0H1 

gRsacoai 

2RSBCJM1 

3RSBC3SI 

SRSBCOrHl 

3BSBC0M1 

srsbcosi 

SBS3C0M1 

gRSBCOMl 

BHSBCOH1 

3BSBC3S f 
3BSBCOH1 


gRSBCOMl 


gaSBOOMT 
3RSBC3M1 
3RS8C0H1 
3RSBC081 
3RSBC0M1 

3BSBCDM1 

3BSBCOM1 

2HSBC0H1 

3BSB3381 

2RSBCOM1 

\ 


3RSBC0M1 


rSSSBJJMH 

28SBCJM1 

3RS3C0H1 


00372 
? V' lH 
:::75 

: 3975 

-;a? 7 


opti on 1 

Specify eitaer tae caincter or two contiguous hexaaeciaal 
digits ( 0-9 o r A-F) cast tae_ editor is to search the rile 
for ana subsequently liter the fiie at that location to the 
second option. 


00079 

oooai 

3 CO 82 


option2 

Specify either the character or two contiguous hexadeciaal 
digits (0-9 or A-F) that the editor is to alter the file to. 


0308* 
C 0035 
30085 
00087 
0 3089 
■00393 
00091 


n or * 

Starting at tae current line, n indicates the nuaber of 
lines to be searched. If * is entered, tae search is 
perforaed until the BOF condition occurs. If this option is 
ositted tnen 1 line is searcaed. If The 20F condition exists 
when the H.T2B suncoaaaaa is entered, scanning starts at the 
top of the fiie. 


93093 
3 00 95 
03095 
3 309 7 

00098 
0 3099 


a or * 

Indicates, during the scan, to alter every location in the 
lines specified that contain the data indicated by the first 
optioa. If onitted only the first occurrence in each line 
specified is altered. Mote : The default, J, cannot be 
specified. 


0 9103 
03132 


#ita verification, eaca line is printed at the terainal as 
it is altered. 


00105 


30Trga sobcohmamd 


00136 

00137 

33133 

30103 

09113 


lou can use the BOTTOM subcoaaand to aaxe tae last line of 
the file tae current line without encountering the EOF 
condition. Mith verification, the line is printed at the 
terainal. The 301131! subcoaaand does not have any 
paraaeters. 


"*3712 

03113 

33114 

00115 

00115 


i—---1 

| Suocoaaand | 

»—-1 

| {BOTTOM|B} | 

«__.. ... I 


00121 


JAS2 SUBCOMMAND 


93123 

"3129 

33125 


rfith the CASS subcosaani you can indicated how the editor is 
to process or inquire now tne editor is processing uppercase 
and lowercase letters. 


16 



I3S COhFIDEBTIAL 


2ES32011 *1127 
2533C3.il 12123 
2533ZD11 '*123 
?F33:311 *‘■713 j 
25332311 77131 


i--- 

| SuD:oiiiDi | Paraaeters I 

,- 1 - - 1 

l tiSi I i a13 i 


SBSBC011 00135 
2BS8C3N1 "0137 
2H532311 70138 
2ES320S1 00133 


a 

a iaiicates that the editor is to accept both uppercase aad 
lowercase letters roc the file as they are entered at the 
teraiaal. 


3BSB20H1 00141 
33SBZDS1 00143 
2PSBC3S1 00144 
3SSB23S1 00145 


3 

a indicates that tne editor is to translate ail lowercase 
letters to uppercase letters before the letters are entered 
into the file. 


2BS3CDS1 00145 The editor assuaes J for ail filetypes except HESO and 
3E53C3H1 *0147 SE&I?r. If a paraaeter is not specified for CASE, the 
25SBC 31 1 00148 present setting is printed at the terainai. If a logical 
2B53C3S1 00143 line follows the CASE suncoaaand in the saae physical line 
2SSBC311 00153 {separated by the CIS liaend caaracter), translation or the 
2 R 53 C 011 00151 logical line is not affected. 


2BS3C0S1 39154 


Si AMGS SOB COMaAS D 


EBSB79B1 00155 rfhen you issue the C3ASGE sabccaaand, the editor searches 

EHSBCD11 00155 all or any part of a file for a group of characters and 

38S3C3J11 00157 changes that group of characters to another group of 

38S3C0M1 00153 characters. 


E5SBC3S1 02161 
EHS323S1 01162 
EHSBCOal 01163 
S8SBC3H1 93164 
EHS3Z9H1 00165 


i-----—-1 

| Suocoaaand | Paraaeters | 

,-j--j 

| (CBAMGEI Cj | /(string 1}/£stcing2}£/ £1|n|* £JiGl*j]] | 
» -____—--1 


3HSB7311 90169 / 

2BSBZD11 11170 Specify any unigua ueliaiting character that does not appear 

28SBCOS1 02171 in the string. 

KBSBCasi 90173 stri ng 1 

23S3^3Bi 00175 Specify tne group of cnaractars to be changed. 

3BSBC3H1 00177 st£iaj2 

235B2D.il 12173 Specify tne group of cnaracters to be inserted. 


3BS3CDH1 99181 

2BS3ZD.il 01183 
Z83S2D91 11133 
E2S32DH1 ''0134 
28S32DH1 90185 


a o r » 

Starting at tne current line n indicates the nunner of lines 
to oe searched. If * is entered, the search is performed 
until the EDF condition occurs. Ir this option is oaitted, 
then one line is searched. If the EOP condition exists whea 
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11& CQNFIUZXTIAI. 


3B33C3S1 

'3137 

the CiANSE coaaand is entered, scanning starts at tne top 

or 

25SBC311 

33133 

the file. 


3BSB33H1 

03193 

j oc « 


2B53C3M1 

3 3191 

Indicates, airing tne scan, to caatge every occurrence 

of 

3BSBC3H1 

3 3192 

stringl. If omitted, only tne first occurrence in eacn ine 

BBSBC381 

00194 

specified is chanced. Note: The default. 1. cannot 

be 

SBSBC331 

03195 

specified. 


2BS3C392 

03001 

3itn verification, eacn line is printed at the terminal. 



2BSBC0B2 03013 ^HS SiJ3C08HAN2 


2PSBC392 30014 lae CSS subcommand causes tne editor to enter the CHS Sunset 

2E5BC0S2 30315 soda and allows you to execute those CIS coaaands that do 

333B33S2 30015 aot reguire tne usa of the main storage aeiag used by the 

2BSBC392 30^17 editor, 

2BSB3332 30019 ,-- 

2BSBC082 00023 j Subcommand | 

2HSBCOH2 3C021 |--—j 

2BSBCOS2 0 3C22 i CHS J 

28S3C3S2 ''3323 t--» 

2BSB2392 30C27 f he CSS coaaands taat you can execute are: BENAHE, DISK, 

2BSB33S2 30023 221SS, 2X23, dUSHr, LlSi'FILE, PilMI, PUNCH, BEADCABD, TIP2, 

3BSB33S2 33029 A2C2SS, STATE, and S2T. Any atteapt to execute an invalid 

2BSB33H2 33029 CBS coaaand or one whica requires aain storage provokes the 

BBSB3392 33031 response ?C9S SUBSET: ... . Th€ coaaands LOAD, INCLUDE 

2BS3C382 33032 (S2S2T) , SIA3T, ana BUN should not he executed. To resuae 

2B5B3092 33C35 «. editing, enter the wMS coaaand EETU3N. 


XBSB33B2 00033 DJLEIjS S0B CO39AN D 


3asa2392 33039 The DELETE saocomaand allows you to delete all or any part 

3BSBC3B2 33043 of a file. The new current line is the one following the 

3BSBCOS2 33041 deleted lines. 

2B3BC392 33043 ,---- 

38SBCD92 03044 | Subcoaaand | Parameters | 

2BSBC382 3 304 5 1--1-1 

3BSBCOB2 00046 | (DEL2TE| D2L] | [1|a|*] | 

28SB 33 12 3 3047 t- j 

2BSBC082 33051 o_or_* 

2BSBC382 "'3052 Starting at tae current line, a indicates the number oi 

2HSBC3H2 33053 lines to be deleted. If * is entered, the remainder oi the 

2BSBC392 33054 file is deleted, as * indicates ECF. If oaitted, one line is. 
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3R5333M2 '0055 


jeleted. 


2BSBCD12 30053 




2BSBI3a2 

0 0059 

The DDBM suocoaaand allows you 

to advance the pointer 

do wn 

2BSBI3B2 

n 306 3 

or focward into taa tile. Tae 

line pointed 

to becomes 

the 

2BS3CDB2 

' 0061 

new current 

line. 




2RSBI3S2 

0 0063 

, t ——— 

_ _, 




SHSBOOSU 

00C64 

| Sahcoaaand 

i Paraaetars | 




3BSBCaa2 

00065 

1-— 

-1-—-1 




SBSBCOB2 

00066 

1 CDOiBID] 

1 ; n n j 1 




3RSBIJS2 

00067 

l_ 

—• 




2BSBC012 

00071 

a 





28330032 

0)072 

Starting at 

tae currant line. 

n indicates 

the nuaber 

of 

2 asac:oa 2 

0 G 0 7 3 

lines to advance tae pointer. 

It emitted. 

the pointer is 

2ESBI0H2 

0007 4 

advanced one 

line. 




2BSBC032 

00073 

Bith veritication taa line pointed to is 

typed on 

your 

2BSB-3R2 

00075 

teraiaal or 

if the DOHK suhcoaaand encounters EOF, 

the 

3BS3COB2 

00077 

sassage EOF: 

is typed. 





3BSBCOH2 00083 


F£LB SUBCOSSAMD 


2BSBCDH2 03082 
3RSBZDM2 33032 
3BSB0032 0 308'4 


The FILS subcommand allows jou to aodify the tile 
identification specificatioa originally supplied in the 
initial 2DIT parameter list and/cr write the file onto dish. 


SBSBIDH2 00083 
2BSBI382 C0087 
2S3BC0H2 OOC88 
SBI032 0003 3 
0BS8I3S2 '•OOOO 


| Suhcoaaand | Paraaetars 
| FILS j £ filename [filetype 


[fileaode ] J ] 


I 

I 

I 


BBSBCOA2 

0009* 

filename 


2BSB2082 

00095 

Indicates the filenaaa for the file. The filename can also 

2BSBCOS2 

00097 

oa changed by the FhAdS subcosaand. 


5RSB-OB2 

30099 

fiiatlfie 


2BSBIJ32 

0 0101 

Indicates the filetypa for tae file. 


SBSB3032 

00103 

tileaade 


2333J)32 

v- ' 10 4 

ladicates tileioda foe tue file. The rileaode 

can also be 

2? 33)332 

0 01-36 

changed by the F3JJL sancoaaanu. 


23S9C032 

00107 

Any existing file tnat aas an identical fileict 

is replaced. 

2BSBI132 

00133 

and tae operation of the editor is terainated. 

If errors 
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13 a CO HP.ID EK-T1 A.L 


3SS30312 '2139 

35330312 ::■ 11 3 

3PS30312 *:in 
? ?53:3-: ''ii2 


ice encountered in performing the operation, 
actioa lassiges are typed and ccntrcl returns 
to allow recovery attaapts. See Appendix 
lessages. 


appropriate 
to £DIT node 
3. Editor 


3BSB0312 00115 


FI HD 5UB0081AHD 


3B53033? 3:115 The FIMD suocoaaaad allows you tc search all or a part of a 

33530032 “9113 file for a line of data. 


Z5S30012 '9123 ,- , 

23SE0332 09121 i Suocoaaaad | Paraaeter 1 

35330332 33122 I-1-—| 

32S30032 03123 | {FIHDJF} | i line] | 

3E530312 9">124 i—- « 


2BSBCOH2 00123 line 

3BS30032 09123 Indicate any valid input line. It aay contain blanks and 

3BS50032 93133 tabs. 


33S303fl2 39132 The file is searched, from the next line, exaaining only 
33530032 39132 those characters in eaca line which correspond in position 
£5330912 9 9133 to tne non-blank caaracters m ‘line*. The first line in 
B3S80312 99134 which a natch occurs oecoaes the new current line. If none 
2SSB03S2 33135 is found, the aessage HOT FOOHD is typed and the EOF 
2E530912 9"'136 condition is raised. If ‘line* is null or blank., the search 
£5SB0312 9 9137 is successful on the first line exaained. If the EOF 
E3S30912 30133 condition exists when the FXHD subcoaaand is issued, the 
2HS30012 99139 search starts froa me top of the file. 

ESS309S2 ”33143 Hith verification, tne line is displayed at your terainal 
2B330932 “3142 when it is found. 


2BSB00H2 

99145 

PIODi 30B0011AND 




EH3B0912 

9 3147 

The FSOOS subcoaaand allows you to reset the 

fileaode 

for 

3BSB0032 

3 3143 

subsequent PILE and SAVE subcoaaands, or display 

the 

current 

3BS30312 

\ 

99149 

fileaode setting. 




£55^0912 

33151 

i— -1 




3BS30312 

93152 

| Suocoaaand | Paraaeter | 




£3530912 

'“153 

1-1-1 




3 53533.12 

' M54 

1 [F1JD3 |Fil} | [ fileaode j | 




2PS5 3 912 

■'"'155 

i-1 




3BS30 912 

90159 

Ilieaode 




330 312 

“3161 

Indicates the fileaode that is to replace 

t.hfi 

current 

5PS50012 

93161 

fileao.de setting. LL only a node letter is 

given,. 

th^ 
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2353:312 '33162 
2333:312 '"163 
233313.12 I ; 154 
23532312 TMoS 


existing sole nuaber is retained (or if the previous aode 
was •SI', the aode nuaoer is aaae •1■ and the new aode is 
typed! . If tae iiieaoae is aot specified, tnen the defaults 
are: 


BBSBCOB2 03168 


Far gristing Files : Tae fileaode is not changed. 


5BSB2DS2 00173 for Mew Files : The fileaode in EDIT paraaeter list is 

2B53C3S2 03172 displayed. If a fileiode does net exist then A1 is assuaed. 


2BS3C382 33173 
3RS329H2 03174 
28532312 3 317S 


If a subsequent FILE or 5A7E is issued and the editor 
deteraines that tae fileaode prevents writing, a aessage is 
typed to tell you to change tae fileaode. 


3BSBC3B2 

00179 

£1411 S0B2 

011A3D 





35532312 

33133 

The PHASE 

subcoaaand allows you 

to reset the filenaae 

for 

3RS320H2 

33131 

subsequent 

unqualified FILE and 

SAVE 

subcoaaands or display 

3SSS2032 

03132 

tae current filenaae. 





3BSB23H2 

33184 

i----- 



T 




2BSB23H2 

93185 

| Subcoaaand I 

Paraaeter 

1 




3ESB23S2 

33135 

1- 

-1 


-1 




3H5B23S2 

3 3137 

| (FM A BE | FN} 1 

[ filenaae j 

I 




3HS32332 

33133 




J 




KBSBC0H2 

00192 

filenaae 







32SB23H2 

03194 

Indicates 

tne 

filenaae 

that is to 

replace the current 

3BS323B2 

00195 

filenaae. 

If 

the filenaae is 

not 

specified, then 

the 

3BS323H2 

90196 

filenaae froa 

the EDIT paraaeter 

list 

is displayed. 



BKSBC3B2 00199 


3BTPIL B SOBCOBBAMD 


25332312 33201 The 5ETFILE subcoaaaria allows you to insert all or a part of 

2FS32JH2 C-0202 a specific file into the file that you are processing. 


3HSB30B2 9323<* 
2BSB2332 03235 
3RSB23H2 33236 
KBSB23H2 00237 
2BS323B2 33233 


i-■-------------1 

I Suocoaaand | Paraaaters | 

I (GETFILE|G} | [(filenaae) [tiletype (*|fileaode]] [ J|a [*|n] | 

i---« 


3HSB2332 03212 
3P3B:)12 "3213 
35552312 "3215 


filena ae 

Indicates the filenaae or tne file that contains tne aata to 
be inserted into tae file you are processing. 


3BSB23B2 93217 iii§ty£e 

3B532312 30213 Indicates tae fiietype of the file that contaias the aata to 
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'‘3219 
2F352332 ” 3-223 
EF.SOEJIl : 7 2 21 


oa inserted. If filetype is aot specified, the fiietype in 
the EDIT parameter list roc the file you are processing is 
assumed. 


21SB2JH2 33223 
ER5BE3S2 ^3224 
2RS333H2 03225 
S3SB23B2 33227 


fileaode or * ' 

Indicates the fileaode of the file that contains the data to 
ba inserted. If fileaoia is aot specified, then * is assumed 
and all disks are searched until the file is found. 


BBSBC082 33229 a 

2RSS2392 00233 a indicates the nrst line of the file that is to be 
2ES3C032 33231 inserted into the file being edited. If a is omitted, then 
3RSBC392 03233 the first line of the file is assuned. 


2BSBCOH2 30235 j M * 

3S5B2092 33233 Starting with tae line specified by s, a indicates, the 

ERS3C392 33237 auaber of lines to be inserted. If a nnaber is aot 

3HSB2392 33233 specified or * is specified, then all or that part of the 

2RS3ED32 3023-9 file between a and EOr is inserted. 


28333392 03243 
28SBC0R2 03241 
28SBC3B2 33242 
2BSBC392 03243 
28SB2D32 00244 
2BS3C3B2 30244 
22SBC092 00246 


With verification, if EOF of the the file containing the 
data is- encountered, tne message EOF REACHED is typed. The 
last line inserted becomes the new current line. If the 
racord length of the file containing the data to be inserted 
exceeds that of the file being edited, a message is typed, 
and the GETFILE is not executed; if shorter, the records 
are padded to tne record length of the file being edited. 


3BSBC382 00249 


19A33 SU BC099A HD 


2HSBED92 00253 Tne iaAGE subconaand allows you to control the building of a 
2RSBC392 33251 ’line image' for input entered in the fora of line, turn on 
2B5S2392 33253 canonical ordering, or display the current 1BAGE setting. 


EBSBC092 30255 
2S3323S2 33256 
35S3C332 33257 
E3S3C092 33258 
2BS32392 30259 


«-----1 

| Suocoaaani ] parametars | 

I-,-1 

| XBASE | [ OS | OFFJCAhON] | 

«___ 


SBSBC3B2 00263 

ERS3CJ92 C3264 
23^32092 30265 
2BSB2392 30265 
EF.5B2092 0 0267 
2BS32092 0^268 
2RS3C0S2 0C2o9 
ERS33332 03273 
2RS32392 03271 


21 

If OH is specified, text entered in the fora of lines, as in 
FIND, INSERT, QY2RLAI, and REPLACE, is expanded into a 'line 
iaage' whre backspaces are removed and tabs are replaced by 
the appropriate number of blanks. The process- that builds 
the line image simulates a . typewriter having per line 135 
columns for printing and the appropriate tab stops. If the 
input line contains backspaces, tne coluan pointer can move 
forwards and bacxwards. The rales are as follows: 


EBSB2392 3027$ 


• Characters in the line image that are backspaced.over. ace. 
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335S:3h2 

2RS32DH2 

285BCD12 

2FSBCDB2 

2S33C 332 
2aS3C3S2 
38383332 
28383332 

2HS333S2 

3RSB3332 

2HSB33H2 

38333332 

2ESB3332 

2HS33332 

3R533382 

38S333S2 

3SS333H2 

28SB33H2 

E8SB30H2 

2HS83332 

28S33332 

28S333H2 

25SB3382 

2RS33332 

28SBC3B2 

2HSB3332 

2HS33332 

2ESB3332 

25333332 


BBSBCOB2 


25SB3^M2 

3RS33332 

283B3382 
2R33:332 
25383332 
28333 )>12 
25SB33S2 


3 3 27 7 


not affected. 


' ?25 j 


® Characters mat are iovea ofer forwards are replaced. 


: :2»2 
30253 
30284 
ft 0285 


If an atteapt is 2 iie to put a aoD—blanx character beyond 
coluan 135 or if a non—blank character is left in the 
line beyond the coluan of truncation for the file, then 
truncation occurs. 


33283 

33299 

^3290 

33291 


Text entered in the fora of deliaited strings, as in CHARGE, 
LOCATE, and (effectively) ALTER, is not expanded. Thns, 
tabs and backspaces are treated in the saae way as other 
characters. 


33292 Except for 33RIPI files, OH is assuaed for all other 
00293 filetypes. 

00295 OFF 

30295 if OFF is specified, then tabs and backspaces are treated in 
03297 the saae way as other characters. Thus, they enter the file 
3-3293 without being expanded or reordered. 

0933) In the saae line or input, when a line of text follows a 
00301 subcoaaand, tne text starts at the character that terainates 
33302 the subcoaaand if the terainator is not a blank, or the text 
33334 starts at the next character if it is a blank. 


00306 
3033 7 
03333 
93339 
•'0313 
93313 
35311 
3T312 
0 33 1 3 
33315 


CA HOS 

Backspaces can be used to produce coapound characters as in 
underlining. Before they are inserted in the file, coapound 
characters are put »into a canonical fora which is 
independent of tne order in which their coaponents were 
given. (Backspaces are arranged singly between the 
caacacters wmcn overlay each other, and the overlaying 
characters are arranged according to their EBCDIC values.) 
Tab characters do not receive special treataent, and enter 
the file in the saae way as ordinary printing characters. 


3 3 317 


Zh H3H is assuaed for SCRIPT files. 


00323 


fJJPUT SOBCOSBAHD 


03321 Tne INPUT subcoaaand allows ycu to create new files or 

99323 iasert new data into in existing file. 


‘ 3325 
''9323 
''327 
" 0 323 
n 32 9 


| Subcoaaani 

I- 

| (INPUT | 1} 


| Paraaeter | 
I i linej I 





Ilia XaSEX.DdEH.XLAL 


3BSBC3H2 

3ass:Dn2 

2R53I5!12 

3RS323S2 

2BS3G0H2 

3BSB33A2 

3BSB23B2 
3BS333S2 
2BSBLDB2 
2HSBC Jf!2 
EBSBC0B2 
EBSBC392 

3BSBX3H2 
2BS3CJB2 
2BS3J3S2 
2BSBJOB2 
2B S3 Cl 8 2 
3BS3C7H2 
2HS3C0H2 
3BS3C3K2 


3BSB33B2 


2BSBC3H2 

2BSB33H2 

5BSBC3S2 

SRSBCDH2 

5RSBC0H2 

2BS3C3B2 

2RSBC3M2 

2BS3X3R2 

2R3dC382 

2BSBC0H2 

2RSBC3H2 
3BSBC3S2 
EBS3CJB2 
2BS8C3S2 
3R^B30S2 
3BS3C382 
2BSB23M2 
2R5BC3B2 

BBSBC0H2 

2HSBOOH2 

SBSB3JB2 

2BS3C3H2 


line 

Specify the exact input line to be entered into the file. 
It can contain blan&s ana tabs. 

It a line is specifiea, it is pat into the file following 
tae current line and subsequently becomes the current line. 
This option is invalii if LXBSBOBE is LEFT or BIGHT. 

If line is omitted, toe editor enters INPUT node, receives 
lines froa the terminal, and puts thea into the file 
following tae current line. Is each line is entered, it 
aecomes the new current line. EDIT node is restored by 
entering a null line. (1 blank line is inserted by typing 
at least one blank.) 

C0347 If LIS ERODE is LEFT or EIGHT, the editor proapts you with 
70343 line nuaoers. The line nuabers are usually succesive 
00343 multiples of the prompting increaent. However, if the 
00353 aanner so generated for prompting is larger than the next 
00351 line nunoer in tae file, the editor selects a nuaber between 
00353 the current line nunoer and the next line. It a prompting 
03354 cannot be generated, the current line and the next line 
C0355 differ only oe one, then EDIT node is restored. 


00333 
? 0334 
0 0335 

0 0337 
00333 
0034 3 

00 341 
0034 2 
0 0343 
03344 
00345 
0 0345 


03358 U MBB3 D5 SUBC OaSAHD 

00353 The LIME83DE suocomaaad allows you tc choose if the editor 

00361 is to create a file in which every line is numbered in 

00361 ascending order and where the line number is placed in the 

30363 record or to display the current LIHEBODE setting. 

00365 ' ,------- 

03366 | Subcommand | Parameters | 

00367 |--i-1 

00363 | {LIM2S0DSI LINE} | [ * LEFT | L J| [ 2IGHT | B ]| OFF ] | 

0 036 9 «---» 

00373 LgFI 

00374 If LEFT is specified, columns 1-15 are set aside for line 

00375 nuabers. If the file was previously created, the editor 

00375 assumes that all records are numbered in ascending order in 

00377 columns 1-15 and taat all numbers are right justified with 

00373 leading blanks. Ine near zone and the first column in which 

00379 text is entered are set to 7 so the ALTER, CHANGE, FIND, 

0)379 LOCATE, and OVERLAY subcommands do net process the line 

00380 numbers. 

00382 aiGar 

">0383 If RIGdT is specified, columns 7b—6v are set aside tor line 

0038*4 nuaDecs. If the file was previously created, toe editor 

00385 assumes that all records are numbered in asceniing order.in 
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2R53C3S2 ' 0355 
33SBC3S2 '2337 
2RS3C3S2 '3333 


columns 7t>-jj and taat ail numbers are right justiried with 
leading zeros. 31031 is only valid for files with fixed 
leagtn 62-oyte recoraa. 


2R33C3S2 "339 
2RSBC182 03393 
2RSBCDS2 03391 
SRSBC3H 2 0 0392 
SRSBC382 03393 
2RSBCDS2 00394 
2RSBC082 00395 
38SB2a«2 03395 
2RSBC3S2 2^397 


Linas eatereu at tae terminal are reformatted so that the 
line number followed oy a blank appears to the left of the 
line being typed. On entering LIHEflODE BIGUT, the 
verification column is rest to 72 to prevent the line number 
ia columns 7b—30 from printing a second time. In INPUT mode 
you are prompted wita a 5—digit number followed by a blank 
(as whan lines are typed). This number is placed into the 
file in columns 76-30. Its appearance on the left is for 
your convenience and does not indicate its true position. 


2HS3COH2 30393 
2BSBC3H2 00399 
2HS303H2 33403 
2RS3COS2 2 "'4 31 
2RSBC312 23432 
3BS60J312 "'34 3 2 
3aS32DM2 23404 


If a SAVE or FILE command is issued, reserialization in 
columns 7o—5 j is suppressed to allow the line numbers taat 
are saved on disc to nave tne same values they had during 
tae editing session. If LINEhODE is set OF? before issuing 
a SAVE, reserializatina taxes place according to the SERIAL 
options currently in erfect. This allows you to renumber 
all your lines m the middle of an editing sessing. 


ERSBC082 00406 
5RS3C082 00437 
3HSBC382 23409 


OFF 

Ho line numoenn is assumed. There is no prompting in INPUT 
mode. The nnnnnn command with an option is disabled. 


5RSBCOH2 00413 
2RSBC0S3 C0C13 


If an option is not specified with LINE8QDE, the 
current setting is displayed. 


3RSBC083 

00013 

LOCATE SU3CG8SAN0 


2RS3C383 

30014 

The LOCATE subcommand allows you to scan tne file, from 

the 

2RS3COH3 

A 3 0 15 

next line, for the first occurrence of a group 

of 

38SBC083 

20215 

caaracters. 


CRS3C3S3 

: oc 13 

■ " ' ' " ’ 1 


2RS3CJS3 

■'3313 

| Subcommand { Parameter | 


3RSBC 383 

C 3020 

1 -- 1 - -1 


2RSBC383 

3 00 21 

| [LOCATE|L) | [ /strmg[ / j ] | 


3SSBC3N3 

00022 

4_ J 


SRSSCOS3 

00226 

/ 


2RSBC}83 

''3027 

Specify any unigue uelimiting character that does not appear 

2RSBC383 

0 3323 

in the string. / may be any non-blank character. 

The 

2RSBCJ83 

'■'3C29 

closiag delimiter is actional. 


SRS8C3S3 

00031 

string 


2RS3C3S3 

• •:' 3 2 

Specify any group of caaracters to be searched for in 

the 

2RSBC 383 

' 0 ^ 3 3 

file. 


2RSBC3H3 

2 3034 

If it is found, the line containing it becomes the 

new 
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3ESB-DS3 

2RS3C0B3 

3fi3B23!!3 
2333 J l?t3 
28S3C093 
2RSB-DH3 
3RSBCOB3 
3BSBC3H3 
ERSBC3S3 


BKSBC0H3 


2RSB33H3 

2RSBC3H3 

38S330S3 

2BSBC3S3 

BRSB20H3 

3RSBC3H3 

2RSB3DH3 

2BSBCOH3 


SBSBOOB3 


2RSB33B3 

2RSB23B3 

2RSBJJB3 

2RSBCOB3 
2RSBC3B3 
2RSBC393 
2RSB33B3 
2RS333B 3 

2RSB33B3 

2RSBC3B3 

3RSBCOB3 

3RS^C3B3 

2BSB33B3 

3RSB-OB3 

2R5BCJB1 


BRSBC3B3 


33033 current line; otaecvise the message SCI FOUMD is typed, and 

" , '' , '3S tne 23F condition is caused. 


: 3 7 

* 3333 

30039 

OOC4D 

30041 

30042 

30043 


If the opening ieimter is /, tafe eord LOCATE or an 
aobreviation for it n = ed not be entered eitner. Ir the 
string is null, tne search is successful on the first line 
encountered. If the 20F condition exists when LOCATE Is 
issued, scanning starts iron the tcp of the file. aith 
verification, the line located is typed on the user's 
terminal. 


00046 


LOIS SOB COBB AM d 


03043 

The LOIG subcoaaand 

30050 

when an invalid EDIT 

30051 

the default mode for 

03054 

r.. 1 

30055 

| Subcommand | 

30055 

1- —, 

00057 

| LDSJ r 

30C58 



instructs the editor to respond ?2DIT 
suocoanand or macro is entered. This is 
tne editor. 


00063 MBIT SOB CO BBAMD 


00064 Tne MBIT subcoaaand allots you tc point to the next line, or 
00065 „ down a specified number of lines. The line pointed to 
33057 becomes the new current line. 


00069 ,- 1 

00070 | Subcoaaand | Parameter | 

00071 |- 1 - 1 

00072 | {BEXT|H} I Clin] i 

03073 «-:--- 1 

00077 a 

90079 Indicates the nuaber of lines tc advance the pointer. If n 

00080 is oaitted then one line is assuaed. 

00081 I2XT operates identicaiiy to DOWM command. With 

00082 verification, the line pointed to is displayed on your 

' V ~'C83 terminal. Also, ir M3AI causes the the number of lines in 

33085 the file to oe exceeded, EOF; is typed. 


00089 


SOBCOBMAMd 
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?85=:3a3 33:39 
2SS3C3B3 O'091 


Tne JfEHLAf subcoaaam allows you to overlay the current 
line vita tae aon-claa/t characters in the lane specifrea. 


3F33Cj33 ^i:93 
2333C3a3 ::;94 
2RSBC3B3 09995 
3BS3COB3 99C95 
2BS3-3B3 93397 


t Suocoaaaai | Paraaeter j 
! (3T2BLATJO} | {line] j 


S8SB33B3 30101 
38533313 03132 
3ESB-313 9 9133 
23S5C3B3 39135 


line 

Specify an input line that replaces parts or the current 
line. An underscore ia the line specification forces a slant 
into corresponding position of the current line. 


2R3330H3 33136 
28S333B3 r 913 7 
2E53CJ33 33139 


It is convenient to enter this request by typing an *0* 
followed by a backspace followed by the overlaying aatecial. 
This set up the correct alignment on the terainal. 


2853C3B3 39113 
285B3313 33112 


iitn verification, the line is displayed on the terainal 
after it aas seen overlaid. 


3RSBC9B3 39115 


paesBETs saacoaBAMo 


2BSBC9B3 09115 
2RS333B3 03117 
38S3-3B3 99119 


The P225E8F2 allows you to save the current settings of 
CASS, XBASE, LIM2SOD2, LONS, BOOS, MABE, E2CPOEB, SERIAL, 
SSOBT, TASS, TS0MC, TS8XFY and ZCKS. 


2RSBCOH3 93121 
28S3C313 93122 
SRSBC313 ■'9123 
2RS3C3B3 33124 
28S3C0B3 03125 


1 - 1 

| Subcoaaand | 

I—•--1 

| (P32S2B7E| ?£2j | 

1 -_.....___- j 


2BS9COB3 90133 £B0B?T i2.dC0aaAHD 


2ESBC3B3 03132 
2R5B33B3 39133 
2ES3C333 03133 
2BSBC313 33135 


The PECMPT suncoaaand allows ycu tc change the proapting 
increaent that line nuabers are increaeatea by during line 
nuaber proapting. This is only relevant in IHPUT aode with 
LX8EBJD2 SlSdT or LI NS BODE LEFT. 


38S9C3B3 09137 
?aSd0353 03133 
2F.S30B3 ■'■‘139 
SBSBC3B3 93143 
SB55JJB3 ~' 14 1 


| Suocoaaani | Paraaeter | 

I-1-1 

| PaJBPr I i Jim ] i 


EBSBC3B3 93145 
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•J a 5 B J j * i 
3?-5?J3«3 


BESBCDH3 


E2S3C353 

23560313 

3fi5B_JS3 

3EB3«D’!3 

2BS3i333 

23S3C.X13 

2RS3-5s3 

3R53CJ33 

3F3B-3H3 

2RS833S3 

2B53C313 

3333031 

3RS33333 


BHSB30S3 


EBSBO 3S3 
BRSBOB3 

3SSB3033 
3RSB3353 
2RS33333 
3RS33033 
2RSBC313 

3BSBC3B3 
3F3303 3 
26333333 

BBSBC0H3 

2RS333H3 

3RS30S3 

2RSB3J33 

JbIBCIBI 

ZRS3Z )33 
2RS303.13 


EBSBC3S3 


* 'i-6 
'147 


jl CJ ir ZliEhliAL 


Specify tai prompting increment. It a is c-iitte:, cr.ej 
is assumed. 


03153 


^211 3Q3C0 a3Aa 3 


'0151 
*0132 
0 0153 
00154 
00153 
"0156 
r -015 7 
^3153 


Fme jJIT suocoaaani allows you to tecaiaite tat editor ana 
leave the previous copy of tae file, if any, intact oa tae 
list. If serious errors have been aaae during the session 
and you io not visa to preserve the contents of the fiie 
currently oeing eaitei, then issue the jdll suocooaaad, If 
a 5A?3 subcommand was issued prior to 2011 and tae fixeid 
was unmodified, the fiie on dist contains tee cnaages taat 
occurred luring tne session. 


0 01S3 
00161 
00152 
03163 
0 0164 


i--1 

| Subcommand J 

I- 1 

i vioir i 

* i 


00169 iECFJSS SU6C013AS3 


03173 Itae SECFQBB subcoaaanl allows you tc set tae record format 

10172 for tae file or display the current RECIOE3 setting. 

70174 ° ,---, 

00175 | Subcoaaanl 1 Parameters | 

*0175 I- J-j 

C 0177 | (3 EC FOBS | 323} | £F 1B1 | 

7 3173 «---—-1 

93182 P 

00133 ? indicates frxed iengta records. F is assamsj ror all new 

O^lba files except LIolIaG, da.IO, and SC6IFI. 


09187 ? 

00183 7 indicates variable length reccrds. ? is assumed for all 
C3183 new LISTISG, SEB3, anl SCRIPT files. Usually, a 7 format 
00130 file occupies tae saaiier dist space because trailing claafcs 
03192 are deleted from each line before it is written onto disx. 


07193 If V or ? is not enterea, then the current 32CFGEd setting 

*■'194 is displayed. 


90197 


asPEAT s odia anA.o 
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^psb:ds3 

2BS3C3S3 

ER53C3*i3 

EBSBC3S3 
3BS8C3S3 
28SBC3S3 
BBSBC3B3 
38SBC 333 

3BSBC3H3 
28SB3333 
2BSBC3S3 
3BSBC333 
3RS3C3B3 
3RSBCOB3 

JHS3C333 

38S3C333 

3B33C3B3 

3RS8C383 


3BSBC083 


3BSBT033 

3RSBC033 

2BSB33H3 

3HSBCOH3 

3BSBC333 

2BSBC033 

8BSBC033 

3BSBC3S3 

2HS8C0H3 

3853-333 

3BSBC333 

38SBC333 

3BSBC333 

2BSBJD33 

3BSBi3fl3 

3BSBC333 

3R33C333 

2B5BC333 


3BSBCOS3 


I M33 
' 3199 
'■ >20 1 


Tae REPEAT suocoaadni allots you to 
following GVE5LAZ suocotaaaa or 
specified namer of lines, or tc toe 


sxecutt toe laoediately 
its equivalent for a 
ecu. or tae fixe. 


'023 3 ,---, 

■'3204 | Subcoaaand 1 Paraaeter | 

39235 I—-1-1 

0320S | HEP2AT | [Hn|*j | 

•9320 7 •-- 1 


30211 a or * 

*9212 Starting at cue currant line, a indicates the auaber of 
"'9213 tiaes to repeat tne OVERLAY subcoaaand or xts equivalent 
*3213 that iaasdiately follows. * indicates that tne overlay is to 
*3215 ha repeated until EOF. It n or * is not specified, then 
33217 only one line is overlaid. 

30213 rae last line overlaid necoaes the nee current line. If the 
03219 next subcoaaand is not a valid OVERLAY request or an X or I 
99223 subcoaaand assigned to xnvoxe OVERLAY, the count for REPEAT 
33221 is caset to one. 


0022 * 


4§PLACE SUBC033A8D 


00225 

''3225 

90223 


The REPLACE subcoaaaad allows you to replace the current 
line with a specified line. If a line is not specified, 
then the editor enters INPUT aode. 


93233 
9 3231 
99232 
03233 
99234 


| Subcoaaand 

-, 

| Paraaeter | 

i (REPLACE | R} 
u 

! (line] j 


09238 
3 923 9 
9 324 3 
09241 
39242 
31241 
33244 
’"'0244 
•VO 245 
3 9 2 u 6 


line 

Specify an input line taat is tc replace the current ixne. 
If a line is specified, taen the editor puts it into the 
file in place of the current line. If a line is not 
specified, then tne editor enters INPUT aode, receives lines 
fcoa the teramai, and puts thea into the file inplace of 
the current line. As each line is entered, it becoaes the 
naw current line. EBIT aode is restored oy entering a null 
line. If LIN23JD2 is LEFT or BIGHT, tnea REPLACE is not 
valil. 


30249 aSSTQRE SU dCOad ANJ 
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’ = 3£:J!!3 "253 
^?3320i3 "251 
3d332)’*3 ' *252 
3E553 313 "z53 
33353333 32255 


fae E25T03E suo:oiiiai allows you to restore tae settings of 
EASE, ISASB, LIS ERODE, LON i, FS oLE, rSA.IE, BECPOEd, SERIAL, 
SdOEI, IAj 5, rSJSE, VERIFY an LLaL to tee values they neld 
prior to toe last issued PaESEbTE subcommand or tc tneir 
uitul values if a PRESEE72 saccoamaad has not been issued. 


ZRS8E3S3 ? 3257 
ES5SE3a3 33253 
23552333 2)3259 
28SBE333 23263 
E3S323.13 '3261 


| Subcommand 

I-—■- 

| (&2ST05E 1 323} 

-. .. 


2RSB2353 33266 


SAVE 336C381ASD 


ESS33JS3 3 '267 
EaSB23S3 2'263 


Zae SAVE subcommand allows you to save the rile being edited 
on disi. 


EESB23S3 23273 
3333E3S3 r “3271 
2SSBE0W 2 3272 
3R33E3S3 03273 
EB5BE7H3 '>3274 


1 Subcommand | Paraaeters 

| SAVE | [fiieaaae £ filetype [fileaode]]] 


I 

I 

I 


SRSBCOB3 00273 
ERSB23S3 "3283 


&1SS1M 

Indicates the fiieaaae of the file to be saved. 


3RSBCOB3 30282 
ERSBE3H3 23284 


£ii§tl£e 

Indicates the filetype of tae file to be saved. 


3RSBC3B3 00286 

ZR5BE33 3 3 3288 Indicates tae filenode of tae file to be saved. 

EBSBE033 3">29) The SAVE subcoanand uses the specified fiieaaae, filetype, 

ZRSB3JS3 "3293 and tileaode, or the current values in the EDIT paraaeter 

2ESBE313 *'*291 list as defaults for any paraaeter not specified. Any file 

ER53C3S3 ' 3292 on list that has the identical filename and filetype and 

BES8E3S3 ■''294 tileaode specification is replaced. 


2R59E3B3 03297 SgEIAIj SOBCOSdASD 

SP53EJSJ 2 3293 Tae SERIAL suocoaaanu allows ycu to control the 

2?S3J35J 22333 serialization of recocus m columns 73—83. 

235303.53 ' 302 
33333353 '2323 
3258:353 2'334 
3RSBC3B3 00305 


r -- 

| Subcommand | Parameters I 

1 SEaiAL i [seg | ALL t J?E [10|n]j | 




Ida CONFIDENTIAL 


223533M3 ' '335 


58532383 03313 
’P.S3J113 '311 

735323.13 :: 312 


Specify tarea-:a i iracter identification to be usea in 

coluans 73-75. 


SBSB20B3 0031% 

2RS323S3 00315 
2B332353 "3317 


Jl 

Indicates the first taree characters of the filenaae are to 
oa used in coluans 73-75. 


EBSB20B3 09319 ILL 

25S323M3 i''321 Indicates coluans 73-33 are to be used for serialization. 


2HSB20S3 00323 JFF 

3B5S23M3 / '3324 Indicates serialization or an identifier is not to be placed 

2BSB2133 C 7325 in coluans 73-80. 


5RSB2DS3 00327 

2BSB23S3 21328 
gaSSJim 23329 
2BSB2333 '0331 


a 

Specifies tne increaent for the line nuaber in coluans 76—80 
(or 73-30). This nuaoer also hecoaes the first line nuaber. 
If n is not specified, then 13 is assuaed. 


2BSB2D83 22332 
3BSB23H3 33333 
2BS320B3 3333% 
3BSBC3M3 33335 
2BSB23H 3 23335 


Initially, serialization is deterainei by the filetype 
specified in the EDIT coaaand. The SEBIAL subcoaaand is 
valid only if the file uses fixed length records with a 
record iengta of 80. It taxes effect after a FILS or SAVE 
subcoaaand is issued. 


23SB30S3 73337 
33582333 33333 
3R3B2083 33333 
3BSB20S3 33343 
EBS82033 33341 
3BS320M3 23342 


Boreal serialization consisists of a 3—character 
seguence—naae in coluans 73—75 followed by a 5—digit nuaber 
ia coluans 76-80. This is obtained by issuing SEBIAL with a 
seguence—naae or by using the ON option (which aeans that 
the seguence naae is to be taien froa the first three 
characters of the filenaae of the file being edited. 


3BS320M3 23343 An alternative fora of serialization uses an eight—digit 
33SB2383 37344 nuaber in coluans 73-30. This is obtained by issuing SEBIAL 
28S32083 22343 ALL < Serialization can be turned off by issuing SEBIAL 
3H332933 77345 OFF. 


SB S33353 33347 
EBSB20B3 33343 
SRSB23B3 33349 
3BSB2D83 33353 
3BS83313 77352 
\ 


rinen serialization is luaicateu, tne editor sets TBUNC to 
the ainiaua of 72; the existing setting is changed, the 
aessage TBONC SET TO 72 is typed. The end zone is also set 
to 72; if the end zone is cnanged, the aessage END ZONE SET 
TO 72 is typed. The setting for VEB1FT is not changed. 


3BSB20B3 

33355 

sagar subcommand 




?35d 3 >33 

n "353 

Tae saoar subcoiaaai 

allows you to change 

the 

aessage 

SBSB30 3 3 

:-7353 

response aode. Invalid 

EDIT subccaianas invoice 

the 

response 

3RSB20M 3 

7359 

n « 
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3RS9:3a3 

"36 3 

i— -1 

2253C3M3 

* " > ?a4 

| Subcoaaand | 

2353C3S3 

3a 5 

,--1 

3H33C3S3 

: *366 

| SaOiT 1 

2BS3C7J! 3 

"367 

t_■ 


3HSBC393 33372 STACK SOBCOMSASD 


2E5BC333 ? 3373 
ERS3TOS3 : "‘374 
3RS3C393 3:375 


The STACK 3aocj*aaai allows you to stact lines or EDIT 
stibcoaaands in the terminal input buffer for subsequent 
processing. 


2BSBC333 3 3377 
2BS8CJ93 C 3373 
2E33CJ53 * 337 3 
2RSBCDS3 03383 
2B5BC3.13 : ^33 1 


i---n 

| -Subcoaaand | Paraaeters | 

t STACK 1 [ 1,| a| suDcoaaand ] | 

•—____—Z__—___i 


2BSBCDB3 03385 
3SSBC793 7333S' 
2BS8CJ93 “0333 
3BSBOS3 :■ :3o9 
2RS3C393 "3369 
2BS8C0&3 33393 
2BS3C3B3 *‘3391 
2RS3C3S3 “^392 
2RSBC393 *3393 


a 

Indicate the amber of lines to be stacked. If a number or 
a subcoaaand is not specified, then one line is assumed. 
Stack n lines (FIFO), starting with the current line on the 
terainal input buffer. The last line stacked becomes the 
new current line. The length of the lines is taken froa the 
coluaa set by TBUiiC. If STACK is issued with an argument of 
3 (zero) , a null line is stacked. A aaziaua of 500 lines 
can be stacked. 


ERS83DM 3 ! 3394 
3BS3C393 "395 
2RSBC3S3 ** 3395 
ERS3C39J ::-397 


Specify an EDIT suDcoaaand to be stacked. If a subcoanand 
is specified, it is stacked FIFO. STACK enables subconaands 
to be issued froa the file, and also Bakes it possible to 
more or copy lines. 


2BS3COH3 33*33 TA BSBT COMSAND 


2RSBC3S 3 "'3431 The TA3SBT subcoaaand allows you to set the logical tabs for 

ER53C393 33432 the file. 


2Rsaccm 

3 ^ 4 3 A 

l — 


“1 

IRSBC J!13 

* 3405 

| Subcoaaand | 

Paraaeters 

1 

2RS3C3M3 

"••*3 5 

,- 1 


-1 

SRS8C333 

* *43 7 

| (TA35£T| TAcsS} | 

(u Q ... a l 

1 

2RS9CJ*3 

"413 

1 1 

l 2 X 

1 


'"all 

t. — 


—1 


BB5BC393 03417 a 

2BSBC7S) 3 ■'419 .indicates column posititons -tor logical tab ^settings. ,A 
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3 

iSS320 5 3 
-:ss52“ , *3 

' * 123 
: '-2i 
' '122 


" " - 3 

EBSB2093 

90425 

2RSB20S3 

: >42? 

2E5320.8 3 

*'429 

£3392)83 

'*431 

massesa3 

2PSB2053 

: :i33 
*3435 

3B332 093 
9BS32J83 

'■'4 3? 
* 1433 

£FS323S3 

39332093 

> " * 4 3 
* 3 442 

SBSBC0S3 

00445 

2B5B20S3 

9BS52093 

* '445 

* 3448 

3BSB2093 
33332093 
3RS320S3 
2RS820M3 
2BSB2093 

00453 
: 3451 
3*452 
3 3453 
Q 0 4 54 


2RSB2084 

0DC13 

2BSB23H4 

*3* 14 

3BSB20S4 

33C16 

ZHS83094 

'**13 

SRSB^Oli 

">319 

ERS82314 

' 3*23 

2P332084 

' :'2i 

£?.532 )*4 

3 ''22 

2RS32034 

30025 

2333 2.i'll 

' ' *29 

BBSBC3B4 

00330 


aaxiaaa or 25 is iiio^d. The first tab entry indicates the 
colaan tan the coluin pointer identifies after the first 


depression of tne 

ta 

a k. 

ay 

after 

a carna 

ge return. 

The 

iefauit settings ar 

e : 









Filet/pes 

Tans 








ASSE93L2, UPDATE 

1, 

13, 

16, 

31, 

36, 41 

, 46 

, 69 

, 72, 81 


poaraAS, cosol 

1, 

7, 

1C, 

15, 2 

0, 25, 

30, 

81 



3ASI2 

7, 

1C, 

1b, 

20, 

25, 3C 

, 31 




Phi 

1, 

4. 

7, 10, 13 

, 16, 

19, 

22, 

25, 31, 

37, 


43, 

49 

. 55 

, 79, 

51 





Others 

1, 

o f 

11, 

16, 21, 26, 

31, 

36, 

41, 46, 

51, 


61, 

71 

, 81 

, 9 1, 

1G1, 

111 , 

121 

, 131 


Tab settings ha?e 

no 

effect 

if 

canonical 

ordering is 

in 


effect, or if ISAGc, is OFF. 


TOP 33 BC0& HASD 


The TOP subcoaaani allows you to point to the fop of the 
file. The null top line becoaes the current line. 

i-*-—-1 

| Subcoaaani | 

,--J 

I TOP I 

u._-.-.. —I 


ragh C SUBCOiSAhD 


The TBUH2 suocoaaand allows ycu tc truncate records or 
display the current settiag of ISONC. 


i — 

| Subcoaaani j 

1 -r 1 

Parameters 1 

1 1 

| TRJN2 | 

L Q 1 * J I 

n 

Indicates tae 

coluan at wnicn truncation is to occur 

* 
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16.1 COhrlD EfcT Zkl 


ISSSJOd-t 

'“*32 

Indicates truncation i 

s to oe set 

to 

the record-length. 

0R553354 

' "34 

Set tae coluan of true 

tation to r- 

» 

or to the record length. 

’.'SaJ 3 “.4 

"34 

If no argonaut is spa 

::ei, the 

Cd 

rrent truncation coluan 

E?33_3i-t 

'"35 

is displayed. Tae defaults are: 



3BSB20B4 

00033 

Filetypes 

Truncation 

Coluan 

2R532094 

0 3040 

ASS233LS, UPDATE 

Siniaun of 

71 

and record length 

2RS33394 

3 3341 

FORTRAM, COBOL, BASIC 

Simaua of 

72 

and record length 

2BS3C3S4 

'3342 

Others 

Record length 



SBSB23B4 00047 


TIPS SUB COttBAii D 


2P53C034 

2RS5CJ94 

gaSB-034 

2RS3C094 

2ESBC394 

SBSBC3B4 

ZRSBCOBh 


33"43 

'ooso 

-0052 

0:^53 

33C54 

00055 

33355 


The TYP2 subcotaand allows you to display at 
all oc any part of a tile. 


the terminal 


| Subcoaaanl | Paraaeters 

I-,- 

l triPBiTj 

t_ 


l 

■I 

I C J.I “I * l nl* ]] I 


SBSBCOB4 

BESBCOBh 

SRSBCOSd 

2RS3COH4 

SBSBC3B4 

2R5BC394 

3BSBC0S4 

gRSBCOBh 

2RSBC094 

2RSBC094 

2RSs:oa4 

2S3BZ3B4 

2RSB2094 

3RSBC3B4 

2RSBC3S4 

IRSBCO’U 

\ 


00063 
3 30*1 
33362 
3CC64 

00066 
3 0 A 63 

00071 

33072 
30073 

3 3374 
'0375 
3 3077 
33C77 

33073 
33079 
3 3381 


! 2E * 

-a indicates the nuaber of lines to be displayed. * 
indicates ail lines beyween the current line and EOF. If a 
or * is omitted, then one line is typed. 


Indicates the coiuan at wnicn typing stops. 


indicates that 
length. 


typing is taxing place for the full record 


Display a lines or to SJf, starting with the current line. 
The last line displayed becdies the new current line. The 
aaxiaua lengtn of the displayed lines is aeteramed by tne 
colaan set by VERIFY. To display the entire line, specify * 
oc n to indicate the last coluan to he typed. If LIMEBODE 
SIG3T has been specified, the line nunbers stored in coluans 
76-80 are typed on the ieft. 


SRSBC3B4 30084 


JP SU3C0BMASJ 


2R833 JE4. "■ ■'8 5 

laSBDSd 
2RSBCJB4 3'C87 


The UP 3UDConmana axlows you to iositicn tae line pointer to 
a line with a lower line nuaoer tnan the one that you are 
processing. 




iji CJSrlDZhTIAL 


’FSaZ l *.* 
3H5i;3d* 
£5'5 3 Z )!i4 

2RSBC034 

35533034 

BBSBC0B4 

’ES33D.14 
3P.3B3 334 
3RS33334 

SSS3C334 

SR3B3084 


BBSB3084 


BRSB3084 

38583084 

RRSB0OS4 

3RS33084 

3R533384 

3RSB3084 

3P3B3014 

S8SB3084 

BRSB33B4 

3RSB3084 

3RSB3034 

3ES3C084 

BRSB33B4 

3RS330^4 

38533084 

33SB30M4 

8BSB30B9 

3RS33084 

BBSBCC184 

3P.SB5034 

3B533084 
3R533JS4 
3a.5B5)8 4 
3RSB5334 




*: * o i 
' ■ ~ g ■> 

I Sunronaa 

ni 

1 P draiet^iS j 




0 0093 
: ;■ * 9 4 

00093 

I iJPi 3} 

L 


I ■ ■■ i 

l ili^i I 




n 






' * : 9 9 

In dicates 

the 

nuaoer or lines the pointer is to 

ne iC7ed 

" 1 100 

bacit. If 

a 

nuaber is not 

specified. 

tnen one 

-i JL li •£ 1. S 

: >102 

assuaei. 

Tae 

line pointed to 

beccaes tne 

new curr 

ent line . 


00103 ditn verification, toe line pointed to is aispiiyei it tae 

'*0104 user's terminal. 


0 0107 


IMiil 50d3O 83Aa 0 


'0139 Tae Y33IFY suocoaaana allows you to display ail or any part 

“0115 of a.line at the tarsinal after it is processed or to 

00112 display tae current ¥£RIFY setting, 

0 0 115 ,-, 

"'•0115 I Saoconnand j Parameter J 

0 0117 |-1—-1 

00113 1 J¥3BIF X | ¥) | [OSjOFF La|*J] I 

0 0119 <--—-- 1 


00123 

3M 

*‘125 

Allow verification; 

00125 

aatoaatically typed 

00127 

■ode are indicated. 

C0129 

JFF 

“'131 

Prevents vecificati 

'‘131 

are aot displayed. 

>0133 

ace not indicates. 


located and caangei are 
between ZJII and 1SPUI 


Lines whica are located and changes 
cnanges between EDIT and IhPOT aoae 


Lines which are 
ost, ana changes 


00135 a 

*0137 Zadicates the nuaber of coluans tc verity in each i^ne. 

00139 * 

;0141 Indicates venncatioa of a line tc its record length. 

'■'142 If n is specifies, tae coiuan to waich verification ans 

■'0143 printing is to go; if • is given, it is set to tee iiasit 

'"*144 (i.e. tne itea length). Types out current verify coisaa if 

'0143 ao arguaents are given. The defaults for tais cciuan are: 
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2BSB23S4 

30149 

File t v oes 

Jjx'Ut 

or Ventication 

2P53J354 

233533-4 

9^151 

"152 

&35E25L5, OPOAit, 
JJalalj, 2 ujjL, 

iltj-iu 

a oi 7 2 am rc-cori iengti 

33332384 

90 15.4 

others 

Bacora 

length 

3B5BC3B4 

3RSB2384 

00158 

9 3159 

Mote: If no parameters 

settiags are displayei. 

are entered, the current 


¥231 FI 


BBSB20B4 30162 


i or i SOdCJSSASD 


2RSB2334 9)164 
3BS323»'4 30165 
23382334 C 015 S 


Tae I or I suocoaaands allow you tc assign to 2 or i a ^i?en 
aOII subcoaaand, or execute tae previously assigned 
subcoaaand a specified number oi tiaes. 


2BS323S4 33163 
3BSB23S4 33169 
2E3B23B4 30173 
S1SB20B4 00171 
2HSB23fl'4 30172 


r-—----- t 

| Subcoaaand | Parameters | 

I --1-1 

i {I|7} I [ 1j nj subcoaaana } | 

>,_... -—______Z___1 


SBSBC3B4 03176 
2BSB2334 30177 
2BSB2384 00179 


a 

Indicates tae nuaoer of tiaes tae previously assignee 
-subcommand is to oe executed. 


&BSB23B4 00181 sabcoaaand 

2BSB23B4 33183 Indicates aay 'suocoaaaai. 


2HSB23B4 33185 
3BS3C3B4 33186 
2BSB20H4 30135 
2RSBC3H4 00183 
2BSB33S4 09183 
3BS3C334 93189 


If a is specified and is greater than 1, tae current line is 
aot necessarily advaiced between executions. Advancement 
depends upon tae dit request that has been assignee to i or 
7. 2recution stops at 20?. Ir a number or a request is not 
specified, the previously assigned subcommand is executed 
once. 


253BJ3S4 33191 


i and 7 are initially set to tae null string. 


SBSB23H4 00194 

\ 

2RSB30B4 33195 
SRS3J3S4 30196 
2RS3 J 1fl4 •'3197 
2H3B2>*|4 '''9193 


£211 suB coaa AMo 


The 23tiE suncoaaand allows you to tell tae editor the 
portion of eaca record, starting position and ending 
position, to oe scanned wnen scannin, cccjrs or :j display 
the current JONt settwjs. 


233BJ OM‘4 '. 9 29 3 
?RSB2384 '3201 
2R332084 39202 


i — 


I Suocoamani | Parameters 


I 

-I 


16 
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3ES323B4 00203 
3333 : 0.11 '-:2j4 


i isDSEl Zj I ill PI* 1 il* jj I 
».___I 


31532034 00203 

3335:014 '0210 
33350084 ''0211 


iajia tei 
scaaasi. 


tai first coiuaa or the zone of eaca recou to oe 
Tae default value is ccluan 1. 


SBSB20B4 00213 
3BS3 0 014 03214 
22353084 '‘0213 


1 

Indicates tae last coluaa or the rone cf eaca record to be 
scanned. 


BBSB20H4 00217 « 

23533034 ,, 0213 Iavor.es the defaults. 


3BS32084 00221 
2H3320B4 ^0221 
23532084 00223 


lae ZONE settings are used oy tae ALTER, ChASGS, and LGv-ATZ 
'sabcoaaands. If no paraaeter is entered, the current 
settings are iispiayal. Tae defaults for the ena zone are: 


2BS323S4 00225 




3nd Z one 


23332084 ■? 0227 
2BS320N4 00223 
23SB20H4 00229 


A3SE83L2, UPDATE 
ROarSAS, COBOL, BASIC 

Others 


8iai*ua of 71 ana record lengta 
fimiaua of 7 2 ata record length 
fiecord length 


5BSB20B4 30236 


? 3032088ANO 


3BS320H4 00233 
3BSB20H4 00233 
3BS32084 00240 


Tae ? subcoaaand allows you to display tae iast EDIT 
subcoaaand except AGAIN or a guestion aark. Tae ? cannot be 
entered in the last EDIT subcoaaand to be nulled. 


33S3C3S4 

0 0242 

r~ .. 

—i 

3HS32384 

0 0243 

| Sanroaaani 

1 

3ES3238i 

0 024 4 

»-— 


2RSB23M4 

00245 

1 ? 

l 

3FS323S4 

0 0245 

c 

_» 

3B3B2084 

'■'25 0 

After an i 

or f 

2E332084 

>0251 

reguest that 

was 

3RS320S4 

0 0253 

sjbcoaaanl. 



suocoamaad, the last eait reguest is tae 
xecutea as a result of issuing tae l or Y 


3BSB20B4 00256 


anan a 5032088A^D 


2uSi:314 0 0253 
35S32 084 ■'0259 


2ae ainan siocoaiand iriows you to enter lines into tae rile 
or to searcn the tile cor taat line. 


5R532DB4 "'261 
2aSo20fl4 ;0262 
2R5323B4 '0263 


1 Suacoaaand | Paraaeter | 
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TES3CJ«4 
FBS3T1'?4 

3HS3C034 

2R33C0.14 

3BSBCOB4 

2BSBCD34 

3H33COH4 

EBSBCOBU 

2R5BT'JS4 

3S33CJH4 

3BS3C3S4 

EBSBCOBd 

3KS3C3S4 

EBSBCJBi 

i!5S3CJ!14 

2BS3C384 

3BS3TD34 

2BSBCOB4 

2BSBC3S4 

EBSBCOS'4 

3BS3CJM4 

2BSBCDS4 

3BSBC3H4 

2RSBC3H4 

3BSBC0B4 
3BSBC3M4 
38 S3 CO N4 
ERSBCOT4 
3BSBC0B4 
23S3C3H4 

SHS8C0B4 

2H33C0ft4 

2B3dC0B4 


BBB1CBOS 

\ 

2KBAC303 

3PSAC303 

CrlACaOS 

251ACR03 

2B1AC303 

3RBACROS 


‘264 

'265 


i Qoaaa 


I L text 


39269 
' ‘'271 


nannn 

Indicates a 


xX il £ U Ul Jli w ~ X 


ana 93993, 


00273 text 

00275 Enter a line of text to oe pat into the file. 


0 0277 
' v 3273 
0 0279 
0028 0 
00280 
0 0232 
00283 
00234 
00285 


A line nuaoer not followed oy any text is interpreted to oe 
i revest to locate the line with that number. If sucn a 
line is found it is displayed (unless ?E3IFY is OFF). If 
the line is not found, tne line pcinter is reset to the 
previous line and LISE MOT FOUND is typed. If LISEBOBE is 
LEFT the line nuaoer is assumed to he in columns 1—5 rigat 
justified vita leading blanks. If LINESODE is EIGHT or OFF 
a line nuaoer is assuaed to he in coluans 76-80, rigat 
justified with leaning zeros. 


''0237 A line number followed by text is inserted into the file or 

00283 replaces a line in tne file. 


00293 
00291 
00292 
C 0293 
00295 
0929S 
00297 


rfith 1INESOOE LEFT the line number is paduea vita clanks on 
the left (if necessary) and inserted in columns 1-5. The 
taxt is placed on the saae line at the first tab position 
(aoraaily column 7). The entire reformatted line is placed 
in the file in the location appropriate to its line nusoer. 
If a line with that number already exists, it is replaced. 
Line numbers with leading zeros are not accepted. 


00299 

00303 

■'9331 

0 0 302 
00334 
00305 


iith LINEdODS SIGHT tne line number is padded with zeros on 
the left (if necessary) and inserted in columns 76-80. The 
text is placed on the same line at the first tab position 
(normally column 1). The entire reformatted line is placed 
in the file at tne location appropriate to its Line number, 
if a line witn that nuaoer already exists, it is replaced. 


0)333 
■'0333 
7 030 9 


Vita LIHE3Q0E OFF the text option is invalid. The search 
option operates as ia LINESGjE SIGHT on files which nave 
line numbers in columns 7o-30. 


90015 


£2IT_HACEOS 


O^OIS An edit macro defines a sequence of EDIT subcommands waich 

CO”'17 can be executed oy issuing a single aacro which uses CSS 

00019 EIEC tiles, iavotea fro* tae editor, to stack requests. 

'3021 The following conventions nave been establisned: 

03324 1. EAEC files waich are concerned with edit macros haTe a 

03C25 filename which starts with a . These files are 



.«711 t S 01A L 


m.kZxjl 

"■'23 

rerir; -i to is 'i4.: licro 1 iia.es. 




: "23 

2a An -3i* c*. 

th: 

^ naae cf an £31I 

'rlAOPOS 

■ ':-23 

Jicrj i ii3 (: jriii.a. tie i Laiiai 

T ) i 

i Ol i j Be u h' CfofniDj. j 

75SAC303 

* ::-33 

oy parueters. 



zfinirios 

j 33 

23IT adcros are ii£C tiles watch allow 

you 

to create coaplei 

233ACR03 

■'0034 

23ir suocoaaaais. 



2R3AC303 

"0 39 

f , a- j 



2SSA233S 

70033 

| Macro | Paraaetars | 



iRSAOROS 

0 3C 4 ) 

l-1 --—| 



3BSACR03 

00041 

1 SDJP | iiiaj l 



SaSAISDS 

: ?'42 

t_ -1 



'3F.1A7303 

?;: 4 5 

duplicate tne jurreat ime n uies. 

Tae 

last copy of tne 

2 P.9 A73D> 

:■ o :■ 4 7 

line aecojgo tne n^ * tar tent ur,-. If r« 

is 

oaittea, the line 

se.iacbos 

"043 

is duplicated once. 



2B9AC30S 

"050 

t — 

_ 1 


iBSAOBOS 

V--C51 

| Sacco | Parameters 

1 


BSRAOPOS 

0 0052 

(- j - - 

— 1 


-^SZShZRQZ 

0 0053 

1 SS3V2 t n {£ [ r J?| DJiia j a] It 13 label]} 

1 


ORMAOBOS 

*0054 ... 

1, , „ ■ - 

_1 


3B9AC305 

o 0059 

Sove a lines (starting with the current line) up or acwn • 

3RSA3S03 

00060 

lines; or aove u lines (starting vita 

the 

current line) and 

2R3A3i03 

00061 

insert tnea after 'ianei', or at c.OF if 'label* is not 

iBSACaOS 

0 0062 

found. Tne new co^y or the last line 

sovea becoaes tne new 

3Rf»Ca03 

00063 

current line. The laoei should start 

m coluan 1, ana 

3BSAC303 

•0 0063 

should not contain any lower-case letter 

s. Aooreviations 

3B3A7a03 

01065 

aay be used for 'OP', 'DOwa' and 'TO*. 



3H9A0305 

00065 

Taere is a liait or 3 jJ lines union 

can 

be aovea by one 

3SSACROS 

0006 7 

request. 
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Id* CQUrFl Z £>T l&L 


BRAPPA 90013 A?P2i2ii ii SUSAA** OS LJil CGS HaUD S 


BHAPPA 

BHAPPA 

BRAPPA 

ooeis 

ooci? 

00013 




| Suocoaaand 

1 -:- 

I Piraaeters 

- —, 

I 

- 1 


BHAPPA 



1 


3B1PPA 

0 PC 20 

i ABAIS 

| (subcoaaand) 


BRAPPA 

^? 21 




BRAPPA 

00022 

| {ALTEHl ALj 

I (option1}{o?tion2} (liM* 


3RAPPA 

:::-23 

1 



BHAPPA 

:■ ::2u 

j {3orroaji} 

1 


BHAPPA 

::c25 




—BRAPPA— 

:*^25 

I CASS 

i :hio] 


BRAPPA 

' ->C27 



BHAPPA 

09C23 

| £I3A3S£|C} 

| / (stiin-jl) / (scr in^I} £ / timi* LiiGi*jjj 


BHAPPA 

0 0029 



BHAPPA 

CC033 

I CHS 



BHAPPA 

00031 

1 



BHAPPA 

00032 

| (93L3TE{ DSL} 

1 I il a|* ] 


BHAPPA 

30033 



BHAPPA 

0093* 

| (902 X| D} 

1 :i in] 


BHAPPA 

0 3035 



BHAPPA 

00035 

| TILS 

t ‘cilenaae (filetype (fileaode ] ] ] 


BHAPPA 

00037 

1 


BHAPPA 

000 33 

1 (FIHDl?} 

| jhnej 


BHAPPA 

90033 



BHAPPA 

OOCaO 

| (FS09S1FHJ 

1 1 fileaode] 


SRAPPA 

^0^41 




BHAPPA 

9004 2 

| (PHAflEJ ?N} 

| ‘tilenaaej 


BHAPPA 

00043 



BHAPPA 

00944 

| (GETFILE | Jj 

| (cilenaae} [tiletyE-e ( * |f lleaode ] ] (JJb L*|nj] 

1 


BHAPPA 

CO^dS 



BRAPPA 

00045 

| MASS 

| * OH|OFFtCAHCk] 


BRAPPA 

'■•'1047 

1 

1 


BRAPPA 

0 0043 

| (ISP-JTI1} 

| ‘line] 


BRAPPA 

O' 049 

1 


BHAPPA 

00950 

| (LIHSaOjSI LIMB] 

I "LfiFTILi RIGhTl £ j|GrF ] 


BRAPPA 

00051 


1 


BRAPPA 

C0052 

i (LSIATS| L} 

| ; /string/]] 


BRAPPA 

0 0053 

1 

1 


BRAPPA 

00054 

| L3MS 

1 


BHAPPA 

00055 

1 

1 


BHAPPA 

00056 

| (MS1T| ti) 

1 Ilia] 

1 


BRAPPA 

0 0057 

1 


BHAPPA 

0 j°53 

| (97S3LA7 | J( 

| (line) 


BHAPPA 

' 0059 


1 


BRAPPA 

:?''60 

I_ 

. - _ - ... - - - - - - 
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9^ “ " ——— — 

"" “ “■ ™- ^ ‘ 

-1 

22APPA 
SEA?PA 

''^063 

: 

| SuDCoaaani 

i--- 

| ? inseters 

1 

-1 


SHAPPA 

'':c6s 

1 

1 


SEAPPA 

c:c65 

| £P53S2EVi| PEE} 

1 


32APP.A 

03G67 


1 


38APPA 

03063 

I Qoir 



SRAPPA 

0 3059 


i 


3BAPP.A 

0 3070 

1 (EECFGES | ESC} 

i ‘7i?] 
l 


SBAPPA 

00071 

1 


SBAPPA 

00072 

| BSPSAT 

i :iiqi*3 


5HAPPA 

''■3073 

1 


SBAPPA 

00074 

| fBSPLACS J d} 

1 "line] 


SBAPPA 

00075 




SBAPPA 

■00075 

I £B23roasias3) 

1 


SBAPPA 

0 0077 




33APPA 

30073 

| SA7S 

} * t ilenaae [filetype [lileaoae]]] 


3BAPP4 

00079 


1 


SBAPPA 

00080 

i SERIAL 

| £seqj OB {ALL i OF? [10{a]} 

i 

SBAPPA 

30031 

i 



38AP?A 

33082 

| SH03T 



SBAPPA 

0Q083 

1 

f 


BBAPPA 

00084 

| STACK 

1 * 11n|subcoaaand] 


SBAPPA 

00085 

1 


SBAPPA 

03086 

| £TA3S2T|TASS} 

| (qI d2 . . . ax] 


SBAPPA 

00087 




SBAPPA 

03083 

| TOP 



SBAPPA 

03089 

1 



SBAPPA 

0 0090 

| T80HC 

* :«*!*] 


SBAPPA 

03C91 




SBAPPA 

00092 

| £TTPE|T} 

| ; ll«|* £n|*]] 


SBAPPA 

0 0093 




SBAPPA 

00094 

1 £OP|Oi 

i :im] 


SBAPPA 

03095 




SBAPPA 

00096 

| £?28IFY| 7} 

1 ;08»0?F £ n l * 1 ] 


SBAPPA 

3009 7 

1 

1 


SBAPPA 

00098 

1 (HD 

| |&| subcoaaand ] 


SBAPPA 

3 0999 




SBAPPA 

00100 

| £208 212} 

1 IllPl* Ul*]] 


SBAPPA 

0 3101 

1 



SBAPPA 

C 310 3 

1 7 



SBAPPA 

00104 

1 



3BAPPA 

C 910 5 

| annan 

1 i taxt J 


SBAPPA 

00106 

L_ 

_* 


\ 
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ERAPP3 09338 


a? r 1 £ N 3 IX 3. i-OIIDa 3E3 S AGES 


3RIPP8 

00012 

TRAP’S 

::m3 

TRAPPS 

0001 4 

EEAPPS 

'0015 

TRAP?3 

00017 

E3APP3 

’0019 

ERAPPB 

C0021 

Ert APRS 

O' 1 022 

TRAP?3 

’3523 

ERA??3 

00024 

E3APP3 

’ 5 ’ 2 5 

ERA??3 

00026 

E3APP3 

0 0027 

ERAPP3 

00023 

SRAPP8 

0003J 

2PAPP3 

C 0031 

ERAPP3- 

00032 

ERAPPS 

00033 

ERAPPB 

00035 

EFAPP3 

00036 

ESAP? 3 

00037 

ERAPP3 

* 5939 

ERAPPB » 

00041 

ERAPP3 

5*042 

ESAPP3 

0 004 3 

2RAPP3 

0 00 44 

S2AP? 3 

’0045 

ERAPPS 

'■'0045 

ERAPPB 

00048 

ERAPP3 

0 0049 

ERAPPB 

00050 

ERAPPB 

’9051 

ERAPPB 

0 5052 

\ 


ERAPPB 

00054 

TRAP? 3 

”555 

2RAPP3 

’ ’05 5 

ERAPPB 

0 0053 

;ra?ps 

r r59 

JfiAPPi 

00060 

ERA?? 3 

’0061 


ATAIL1 3LE STOR AGE IS NO« F ULL 

The size of tne file cannot oe increased. Any attempt to 
add lines produces the aessage KG 3CGB. Other coaaands are 
aaaffected. 

CSS 5333ST 

Tne 083 suncoaaand aas oeen issued. 


1QU 

Indicates entry to EDIT node. During initialization, if the 
rilaii specified in tne EDIT parameter list is encountered 
on secondary storage, this is the first response, otherwise 
the aessage NEW FILS follows. Also, during the session, 
this aessage indicates a return froa INPUT node, or 
indicates a null line while in EDIT aode, subject to the 
setting of the VERIFY switch. 

END ZONE SET TO 72 

The SERIAL subcoaaand was issued and the second zone 
specification was set within the serialization field. The 
end zone is reset to column 72. 

EOF; 

The current line pointer is positioned after the bottoa line 
of the file or if tne file is eapty, after the null line at 
the top of tne filet Subject to VERIFY switch. 

EOF REACHED 

The nuaber or lines beyond the starting line specified in a 
3ETFILE request exceeded EOF in the indicated file. The 
lines froa starting line to EOF were inserted in the file. 
Nith verification, tne last line inserted is displayed at 
the terainal. 

FILE IS E8PTY 

An atteapt to FILE or SAVE a null file was detected. If the 
subcoaaand was FILE, me editor exits; if it was SATE, 
there is a return to the EDIT node. In neither case, the 
file is not written. 

FILE NOT FOUND 

The fileid specified in a GETPILE was net round on secondary 
storage. 

JETrlLE IS IsloapLt.r E 

The available storage was exceed while atteapting to execute 
a GETFILE. The last line inserted into the rile is displayed 
at tae terainal. 
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3BAPP3 

0 306* 

ERA?? 3 

' v :-6 5 

E r. A F ? 3 

-'36? 

8BAPPB 

00070 

2RAPP3 

0 3 C 71 

3BAPP3 

0 - 5:72 

33APPS 

00)73 

BBAPPB 

00075 

3BAPP3 

n 1C 76 

2SAPP3 

0C073 

BBAPPB 

00381 

2BAPPB 

A 3C83 

3BAPPB 

00085 

ERA?? 3 

3385 

35A??3 

^ 0083 

BBAPPB 

00093 

3BAPP3 

n 0091 

3RAPP3 

00092 

2RAPP3 

0 0C93 

’8APP3 

00094 

BBAPPB 

00096 

3RAPP8 

00097 

ERAPP3 

00098 

3HAPP3 

00093 

BBAPPB 

00102 

2BAPP3 

00103 

BRAPP3 

0 0104 

3BAPP3 

00105 

BBAPPB 

00108 

3RAPP3 

00109 

3RAPP3 

0 0111 

BBAPPB 

00113 

2BAPP3 

00116 

3BAPP3 

00117 

3SAPP3 

00113 

2BAP>3 

00113 

3BAPP3 

0 0122 

BBAPPB 

00126 

3B A??S 

‘ 012 7 

2RA??3 

'*0129 

3BAPP3 

00123 

3BAPP3 

0013) 


■UTS* STlSriS3 LIJE IS 3SYOHD EOF 

The starting line specified in a GZTFILE points neyond the 
last line of taa mdiCitei file, 

CHARACTER I* LISE SO jiBEtt CQLCiaSS 
A nun-numeric character was found in the coluans reserved 
for line numbers. I he line pointer identifies the line in 
error. 

lipur 

Indicates entry to ISPUI aode wherein lines entered at the 
terminal becoae part of the rile. Subject to TERIFX switch. 

dhiiaa a lime mosher u seeded 
Ihe maximum line nuaber is 99999 . 

MSB FILE 

During editor initialization, if the fileid specified in the 
EDIT parameter list does not exist on seconaary storage. 

md a00 « 

An attempt to input additional lines to a file has been 
detected after tae fall storage message was typed. Any 
stacked lines are cleared to avoid multiple error messages 
or improper suocoamanl execution sequences. 

»3T rOOHP 

The search parameter specfied in the ALTER, CHARGE, FIND, or 
L3C1T2 subcommand was not encountered in the delimited range 
or before EOF. 

READ BRSOR ~ SETFILE IS INCOMPL ETE 

An error, external to the editor, was encountered during the 
execution of a GETFILE. The last line inserted into the 
file is displayed at tae terminal. 

agCOSP LENGTH OF FILE TOO LARGE 

The fileid specification or a GETFILE indicates a file with 
a record lengtn greater tnan the file being edited, 

SB BO BBER LINES 

(a) The line numoer prompter cannot proceed because there 
are no more numbers between the current line number and 
the line number of the next line already in the file 
(that is, they differ by one). 

(b) The next line amber, 10D0CC, is too large. 
aS SgRI ALINATION SUPPRESSED 

Resacializatian oa a SATE or FILE subcommand is suppressed 
wmen LINESOJE is nlGdl so that the numbers used dunug the 
eiitiag session are retained. To reserialize, repeat the 
SATE or FILE with LISE500E OFF. 
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3BAPP3 

00133 

2HAPP3 

* :• 13 a 

ERA??3 

"135 

SF.APP3 

? 3135 

EBAPP3 

: 3137 

3BAPPB 

00141 

EBAPP3 

'■'0142 

ERAPP3 

3 314 3 

SBAPPB 

“0144 

3EAPP3 

0014 5 

SBAPPB 

00143 

3BAPP3 

00143 

SBAPP3 

03153 

2BAPP3 

33151 

3BAPP3 

00152 

SBAPPB 

rt 0l53 

EPAPP3 

r ?154 

SBAPPB 

00155 

2RAPP3 

30157 

SBAPPB 

00153 

SBAPP3 

''0153 

3RAPP3 

30163 

SBAPPB 

. 30161 

SBAPPB 

00163 

SBAPP3 

00164 

SBAPPB 

^oies 

SBAPPB" 

*3165 

SBAPPB 

03167 

SBAPPB 

03163 

SBAPPB 

0017® 

SBAPPB 

00171 

3HAPPB 

00172 

2BAPP3 

0 0171 

SBAPPB 

00176 

3BAPP3 

00177 

SBAPPB 

33173 

2BAPP3 

00179 

SBAPPB 

00181 

SRAPPB 

0 0132 

3BAPP3 

183 

3BAPP3 

00134 

SBAPPB 

00187 

SBAPPB 

"0133 

SRAPPB 

''0190 


S£3IAu 12i_ri_JS i_S 1 dECEPLEI '£. 

Daring :ae dxeca::oi or a SAVE or FILE subcoaaand that is 
sariiiicing a rile, caa :isx becomes tuli cerate the last 
line is written. Toe partial rile is eraseu and tne user is 
notified of toe condition. 

38T Sgi FIL3SJJ3, 04 SATES CHS SCBS 5T AKD CLEAR SOME SPACE 
Baring the execution of a SAVE or FILE, the disx became fall 
prior to writing toe last line. The partial rile was 
erase!. Tne user cm now institute recover/ proceaures 
since the eiitor returns to EDIT mode. 

5?T MS* LLklligl AMD a SEMIER THE REQUEST 

During the execution of a SAVE or FILE, an error occurred 
while altering the naze of the wort-file. Ine user can now 
institute recover/ procedures since the editor returns to 
EDIT node, Tae wort-file remains. It can be erased and a 
different fileid for suosequent SAVE or FILE subcoaaands can 
na specified. 

S TAC KED LISES CL EARED 

Multiple subcoaaands ware detected after the failure to 
increase the file size subsequent to the editor's typing MO 
SOQOS. This aessage is also typed when an exit froa the 
EDIT node occurs to preserve the CBS coaaana environment 
fron stacked EDIT requests. 

I2f: 

The current line pointer is positioned at the null line at 
the top of the file. This aessage appears either after the 
TDP coaaand aas oeea issued or after an OP coaaand has 
positioned tne line pointer at the null line at the 
beginning of the file. 

TOO aAMY LIMES TO STACK 

Daring initialization, the paraaeter of the STACK subcoaaand 
implies storage requirement in excess of that reserved for 
tae execution of the suocoaaand. Limit is 5C3 lines. 

TBUSE SET TO 72 

The SERIAL subcoaaand was issued and the truncation column 
was set within tne serialization field. The truncation 
coluaa is reset, to coluan 72. 

TgOjj CITED 

The current line has exceeded the truncation coluan. If 
VBBIFY switch is on, the. truncated line is displayed, 
followed by tae message IbPJT: if in IHFUT.aode. 

wBOSQ FILS FORMAT EOS ijiMEMOJE RIGHT 

Tne LISSBQDE RIGdl option is net ccafatiole with V-foraat 
files or files taat nave a record length otner than 30. 
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2RAPP3 

* 3193 

ABoAiA FILE ?J55Ar rua j 1 al AL IZ A T 105 



?R A?° 3 

'"19 + 

Tae 5251AL saocouand eas issued for a ?-foc*at 

file or for 

*?.Ar?5 

"'195 

a ilia that does aot save a record length of 

33. 


3HAPP3 

93193 

Z3h£ SaAOA 



23AP? 3 

'3199 

The stringl is too xoag for tae current ZGM2 

specification. 

3BAPP 3 

: ?23i 

me file is not caan^ei. 



3HAPP8 

93233 

Tl 



2SAP?3 

: : 2 c 4 

3a*e as ?Z3ir:... , out the input line is 

not 

displayed 

3BAPP3 

r 3235 

oacausa SddiT is in effect. 



28APP3 

33203 

-.J 



2SAPP3 

C "*209 

3a*e as ?£oir:... , nut is typed with an invalid 

EDIT *acro 

3fiA??3 

2:211 

is issued and 53051 is in effect. 



3HAPP9 

n 0213 

?CHS 5U35ET:... 



3RAP? i 

: :2w 

An untnova coaaand aas been entered. Tae 

complete input 

2EAPP3 

"‘215 

line is displayed for user inspection. 



3HAPPB 

03213 

?£ Dir. 



2HAPP3 

*'3213 

An unrecognizable 2uir suocoaaand or invalid 

subco*aand 

2fiAP?3 

C 3223 

paraaater list aas oean encountered. Tne 

input line is 

2BAPP3 

9 2 221 

displayed for inspection. Tais is the for* 

if 

LOMG is in 

2HGL3SS 

r 99 31 

affect. 
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SRGLOSS 93)94 


GL OSS A jl 


SBGLOSS 

: :co7 

SBGLOSS 

90903 


SBGLOSS 

09013 

2BGLOSS 

'V'C 11 

2R3L0SS 

09012 


SBGLOSS 

39014 

2RGL0SS 

3 9 ' 15 

SBGLOSS 

00017 

SBGLOSS 

339 13 

2BGL053 

3)313 

2BGL03S 

r )92) 


SBGLOSS 

99022 

28GLOSS 

9)923 

SBGLOSS 

03924 

SBGLOSS 

00026 

SBGLOSS 

3)923 

SBGLOSS 

3 392 7 

SBGLOSS 

0)323 

SBGLOSS 

93039 


SBGLOSS 

90032 

SBGLOSS 

39033 

SBGLOSS 

0)034 


SBGLOSS 

09037 

SBGLOSS 

■'9033 

SBGLOSS 

9)933 

SBGLOSS 

90939 

SBGLOSS 

3 )C 41 

SBGLOSS 

99943 

SBGLOSS 

-> 

SBGLOSS 

90343 

SRGLOSS 

'' 3946 


For a aoca complete list of data processing terns, refer to 
j)ata P roce ss ing Glos siry. GC 20-169 9. 


cnara c tar - dala tion c&ar acter : A character within a line of 
taraxaal input specifying that it and the innediately 
preceding character are to be removed frcn the line. 


coaaand scan : A service routine that checks the syntax of 
connands and subcoanands. 


context editing : In systens with tine sharing, a nethod of 
editing a line data set of file without using line nuabers. 
fo refer to a particular line, all or part of the contents 
of that line are specified. 


Cogwersational B oq it oc Systen (CHS) : A virtual nachine 
operating systen that only operates under the control of 
»S/373. 


current line p ointer: (1) In systens with tine sharing, a 
pointer that indicates the line of a line data set or file 
with which the user is currently working. (2) In ¥8/373, a 
pointer that indicates the record nunber of a CHS file with 
which the user is currently working. 


edit nod e; In systens witn tine sharing, an entry node 
under the 3DIT coaaand that accepts successive subconnands 
suitable for aodifying an existing line data set or file. 


IB H Tirtual Machine ga cilitv/370 ffg/370i : A tine-sharing 
Systen Control Prograa that nanages the resources of a 
Systen/379 conputing systen in such a way that multiple 
remote terminal users have a functional sinulation of a 
conputing systen (a virtual nachine) at their disposal. 

^n£Ut_iine: In 7H/37J, information typea by a user fetweeD 
the tine the typing elenent of his termnal coses to rest 
following a carriage return until ancther carriage return is 
typed. 
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BBGLOSS 

000*7 

2RGL035 

? :?tt s 

2=31.333 

* :csb 

BBGLOSS 

0 0052 

BBGLOSS 

0 0053 


BBGLOSS 

0905$ 

E3GL05S 

9 “953 

2BGL0S5 

"9955 

JPSLJ35 

90C57 


BBGLOSS 

09059 

BBGLOSS 

9 09 59 

EHGLOSS 

C9C69 

2BGL95S 

09961 

3RGL055 

9 0062 

BBGLOSS 

9 09o$ 


BBGLOSS 

00065 

38GL03S 

90965 

2HGL95S 

09067 

BBGLOSS 

99063 

BBGLOSS 

090 79 


BBGLOSS 

00071 

3BGL0SS 

00072 

BBGLOSS 

C0973 


BBGLOSS 

0907* 

BBGLOSS 

09075 

2BGL03S 

90975 

2RSL03S 

00977 

BBGLOSS 

09973 

BBGLOSS 

99089 


BBGLOSS 

00082 

BBGLOSS 

9 9033 

2BGL9SS 

9908a 

3RTA3C01 

9990 1 


line-deletion cnaractsr: A terainai character taat 
specifies tnat ail characters are to ae delete a fro* a line 
of terminal input. 


line numbe r: A nuaber associated with a line which can be 
used to refer to the line. 


line namber ed iting: la systeas witn tiae sharing, a aode 
of operation under tna £D1I coaaand in waxen lines or 
records to be souir'ied are referred tc oy ame or record 
number* 


nail lin e: In T3/J7G, a terminal input line consisting of a 
carriage return or line-end cnaracter issued as tne first 
and only mforaatioa after the typing element of the 
terminal has coae to rest following a previous carriage 
return or line-end caaracter. Usually used to terminate 
input node and enter 20IT node. 


passw o rd : In systeas with tiae sharing, a 
one-to-eight-cnaracter symbol that the user aay oe required 
to supply at the tiae ne logs on the system. The password is 
confidential as opposed to user identificatica. Users can 
also assign passwords to data sets or files. 


promoting : & function that helps a terminal user by 

requesting him to supply operands necessary to continue 
processing. 

response tim e: (1) The time between tne suomission of an 
item of work to a computing system and the return of 
results. (2) In systeas with time sharing, tne time between 
tne end of a bloat, or line-end character of terminal input 
and the display of taa rirst character cf system response at 
the terminal. 


verification mode : la systems with the time sharing, a mode 
of operation under the £011 command in which ail subcommands 
are acknowledged and any textual changes are displayed as 
they are made. 
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ERTA3C0S ''OOOl 


contests 


3BPABJ0S 

93933 

IMTRQDOCTIOS .. . 


. 7 

3BTA9C0N 

30009 

Operation of tae Editor.............. 


r *» 

3RTA3C0S 

00313 

Line Pointer....... 


. 8 

3RTABC0S 

' 3011 

IHP3T Bode.. 


. 9 

3RTA3C0N 

00 C 12 

SDII Mode. 


. 9 

ERTA3C0* 

3 ^ ^ 1 3 

Operational Cbaractenst ics.......... 


. 9 

ERTABEOS 

3 0 314 

Bain Storage Exceeded........ ..... 


. 10 

BRTA3C0N 

00315 

Full Oisx Condition....... . 


. 10 

ERTABCOI 

0 C 315 

Top and 3nd-Of-?ila Conditions. ... 


. 10 

EBTA3C0* 

1 30 1 7 

Subcoaaand and Aacro Conventions . 


. 12 

SfiTABPa’I 

C'J'MS 

Editor Error Procedures........... 


. 12 

BRTA3C0M 

3 3013 

Notes on Brit in 5 EDIT Macros. ..... . 


. 13 

3BTA3COS 

0 0321 

EDII S03C0SAAN OS AND 1 iCaOS ......... . 


. 15 

BPTA3C0T 

00022 

ASAIN Subcoaaand ..................... 


. 15 

3RTA3C0S 

0 0023 

ALTER Subcoaaand..................... 


. 15 

SRTA3C0N 

3332 + 

BOTIOB Subcoaaand... 


. 16 

3RTA3COT 

90025 

CASE Subcoaaand...................... 


, 16 

3RTA3C0J 

33025 

CHANGE Subcoaaand.................... 


[ 17 

EHTABCO* 

03327 

CSS Subcoaaand. ... 


. 18 

3RTA3C03 

90C23 

DELETE Subcoaaand.... 


. 18 

5RTA3COS 

00029 

DOBS Subcoaaand...................... 


. 19 

2BTASC01 

00033 

PILE S ubcoaaand. ..................... 


. 19 

BBTA3C0JI 

33031 

PHD Subcoaaand. ..................... 


. 20 

EBTABCO* 

30032 

PBODB Subcoaaand... 


. 20 

BBTABCOS 

00033 

PM ABE Subcoaaand 


. 21 

BBTASCOS 

0303ft 

GETPILE Subcoaaand................... 


. 21 

2HTA3C0S 39035 

IBAGE Subcoaaand... 


. 22 

ERTABTOS 

00036 

IIPtJT Subcoaaand.... 


. 23 

3RTA3CON 

90037 

LIREBODB Subcoaaand...... 


. 24 

3BTA3COS 

00038 

LOCATE Subcoaaand.... 


. 25 

ERTABCOd 

00039 

LONG Subcoaaand.... 


. 26 

2BTABC01 

COOftO 

NEXT Subcoaaand..... 


. 26 

SRTA3CON 

30041 

OVERLAY Subcoaaand.. 


. 26 

BRTA3C0N 

30042 

PB ESSB 7E SuDeoaaand. ................. 


. 27 

3RTA8COM 

00043 

PBOBPT Subcoaaand.... 


. 27 

8R7A8COS 

30044 

QUIT Subcoaaand... 


. 28 

2BTABCOH 

30045 

BECPOBB Subcoaaand... 


. 28 

BBTABCOH 

33 945 

REPEAT Suocoaaand. ..... 
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VS/370 is a system which manages the resources of a single 
System/370 computer such that multiple computing systems 
appear to exist within it. Each such computing system is 
said to run in a virtual machine. VS/370 consists c£ two 
major components: 


00045 

00045 

00046 


1. A control program (CP) , which controls the real 
computer and allows multiple ccmputing systems tc run 
under its control. 
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00050 

00051 

00052 

00053 


2. A Conversational Monitor System (CSS). which runs in a 
virtual machine under contrcl cf the control prcgram 
and allows the user to operate his virtual machine from 
a remote terminal. CSS is a time-sharing system that 
provides a general purpose ccnversaticnal facility 
suitable for program development and problem solving. 


03056 This publication describes the.commands necessary to use the 
00057 components of VM/370; the Control Prcgram. the 
00058 Conversational Monitor System, and the various subsystems 
00001 that run under CBS. 
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00006 £!££&££ 

00007 This publication is intended as an introduction, and u£er*s 
00003 guide and reference nanual for, all users cf the coaaand 
00009 languages (CP and CMS) of VH/370. 


00011 


Recoaaended Prerequisites: 


00016 

00017 

00019 

00020 

00022 

00023 


• Introduct io n to Vic tua l Storage in Sy stga/37C, Fart I 
(Order No. GR-4260) 

• 1B[J Vi£tu^l flashing FagU iti/370 , Intrgdijsi jgn (Order No. 
GC20-1800) 

• Ififl vittaai lasiliii^J7$, 2££iifi^i Siiifle 

(Order No. GC20-1810) 


00026 For coaaands for which additional prerequisite or 
00026 suppleaental inforaation is needed, this fact is noted in 
00027 the text of the coaaand definition. 
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00042 


The najor divisions of this book are: 

• Introduction 

• CHS Coaaands 

• CP Coaaands 

• Appendixes 

• Glossary 
« Index 


00046 

00047 

00048 

00048 

00049 

00050 

00051 

00052 


The Introduction describes the VH/37C environaent, virtual 
aachine concepts, and systen coapcnents and provides 
background inforaation necessary in order to access and use 
the VH/370 systea. It discusses CP and CHS file aanageaent, 
procedures for establishing coaaunication with the VH/370 
systea, general foraat of the coaaands and describes the 
coaaand syntax, typing conventions, abbreviations, and ether 
aids used to ainiaize entry reguireaents 


00053 

00055 


The CHS Coaaand section describes the foraat and use cf the 
CHS coaaands. Exaaples are included. 


00056 

00057 

00058 


The CP coaaand section describes the foraat and use of 
coaaands which are executed in the ccntrcl pregraa 
environaent. 


00060 

00060 

00062 


The Appendixes present a detailed saaple terminal session, 
discuss terainal usage, provide suppleaental infenatien 
about file aanageaent facilities, discuss the CHS Eatch 
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CLPRSFAC 00063 Facility, and discuss coapatihility cf VM/370 with the 

CLPBBFAC 00064 CP/67-CMS aystea available Cor the Systea/360 Model 67. 

CLPRBFAC 00065 The Glossary contains definitions oC teras that appear in 

CLPBBFAC 00067 the text of this publication* 

CLPBBFAC 00068 The Index contains the location of terns and subjects 

CLPRBFAC 00069 discussed in the text. 

CLPRSFAC 00071 In this publication, the tern 3330 is used tc refer to both 

CLPBBFAC 00072 the IBM 3330-A1 Disk Storage Facility and the IBM 3330-A2 

CLPRBFAC 00073 Disk Storage Facility. 


NOTE 

Information in this publication (if any) about the 
following is for planning purposes only: 

• The Virtual-Real Performance Option 

• The Dedicated Channel Performance Option 

• The Virtual and Real Channel-to-Channel Adapter 
a The CMS Batch Facility 

a The Program Product, PL/I Optimizing Compiler 
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00009 INTRODUCTION 


00013 


IIIXUAL fiiCgiNI 


00014 

00015 

00016 

00017 


VM/370 is a system which manages the resources of a single 
computer such that multiple ccmputing systems appear to 
exist. Each such computing system is said tc run in a 
virtual Machine. 


00018 

00019 

00020 

00022 

00023 

00024 


VH/370 consists of (1) a control program (CF) , which 
controls the real computer and allows multiple computing 
systems to run under its control, ana (2) the Conversational 
Monitor Systea (CHS), which runs in a virtual machine. Each 
virtual machine is a functional simulation or the real 
Systea/370 in which CP is running. 


00026 

^0026 

00028 

00029 

00030 


VM/370 maintains a file called ‘ the "user directory" wnich 
contains information about the configuration of each virtual 
machine that nay run in the real machine. The virtual 
machine configuration includes counterparts tc the 
components of a real Systea/370: 


00033 

00035 

00037 

0H039 

O0044 

00045 

00047 


• virtual system console 

• virtual storage 

• virtual CPU 

• virtual Input/Output devices 

It is the function of the contrcl program of VH/370 to make 
these components appear real to the operating system which 
is controlling the work flow of the virtual machine. 


00049 

00050 

00051 

00051 

00052 

00053 

00055 

00055 

00056 

00057 

00057 

00058 

00059 

00060 

00060 


IIllMl System £ 2 &soIe: Since each VH/370 virtual machine 
user is, in effect, controlling his own operating system, he 
must have the means to control it in the sane way the 
operator of a real machine does. The operation of a virtual 
machine is normally controlled ty a terminal connected to 
the real Systen/370 by communication lines although the real 
systea console or alternate system ccnscle may alsc be used. 
The remote terminal is used initially to access or leg intc 
VM/370. A user becomes active by identifying himself to 
VH/370 by keying in a pre-established user identification 
(userid). The userid is associated with a particular 
virtual machine configuration by an appropriate entry in the 
user directory. The user must also enter the ccrrect 
password for his userid; at this time, printing of typed-in 
characters is inhibited (if the terminal is so equipped) cr 
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CLVIRCON 00061 masking (a combination of over-struck characters) is 

CLVIRCON 00061 provided as an aid to maintaining the security cf the 

CLVIRCON 00062 password. 


CLVIRCON 00063 
CLVIRCON 00064 
CLVIRCON 00064 
CLVIRCON 00065 
CLVIRCON 00065 
CLVIRCON 00066 
CLVIRCON 00O67 
CLVIRCON 00067 
CLVIRCON 00069 
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CLVIRCON 00071 
CLVIRCON 00071 
CLVIRCON 00072 
CLVIRCON 00073 
CLVIRCON 00073 
CLVIRCON 00074 
CLVIRCON 00076 


Once VH/370 has been properly accessed, the reaote terminal 
provides the user with facilities equivalent tc these cf the 
operators console for his virtual aachine. The terainal 
acts as the operator's console, and the control program 
provides a set of coanands to simulate the control panel of 
the real S/stem/370. These comiands are available tc the 
user to provide facilities such as displaying and storing in 
virtual storage, IPLing a virtual device, or performing a 
system reset or restart. Further terminal communication 
would be under control of the virtual machine's operating 
system until the control program is again entered. CP 
commands can be entered when the user is in CP command or 
"console function" mode. This mode is normally entered by 
the use of the terminal's Attention (ATTN) key (or its 
equivalent), but can also be entered via special CMS 
commands, use of special interfaces, or upon afcncrmal 
termination of the virtual machine's operating system. 


CLVIRCON 00077 
CLVIRCON 00078 
CLVIRCON 00078 
CLVIRCON 00079 
CLVIRCON 00079 
CLVIRCON 00080 
CLVIRCON 00080 
CLVIRCON 00081 
CLVIRCON 00082 
CLVIRCON 00082 
CLVIRCON 00083 
CLVIRCON 00083 
CLVIRCON 00C84 
CLVIRCON 00084 
CLVIRCON 0OO85 
CLVIRCON 00086 
CLVIRCON 00086 
CLVIRCON 00087 
CLVIRCON 00088 
CLVIRCON 00088 
CLVIRCON 00089 
CLVIRCON 00090 


Vi rtual Storag e: The storage size of the virtual machine is 
defined in its directory entry and may differ among Virtual 
machines. This storage can appear as real storage to 
whatever program executes in the virtual aachine. CP 
manages the real main storage resource as virtual storage, 
utilizing the System/370 Dynamic Address Translation 
facilities this virtual storage management is transparent to 
the virtual machine. As an example, three virtual machines 
requiring 256K each could be run cn a single real computing 
system having 384K of real storage. Eecause there is not 
room in real storage for all users' virtual storage, the 
system uses a technigue called "paging". Virtual storage is 
divided into 4096-byte blocks of real storage called pages. 
All but currently active pages are kept by the control 
program on direct access storage; this direct access space 
is preallocated but is assigned cnly cn a demand basis. As 
active and inactive pages change status they are moved in 
and out of real storage on demand. While the paging 
operation is being performed for one virtual machine, 
another virtual machine can he executing. The paging 
operation, and resultant allocation of real storage tc a 
given user's pages, is transparent to the user. 


CLVIRCON 0^091 Because the virtual storaye appears real to the virtual 
CLVIRCON 00092 machine, operating systems such as DOE or OS, which cannot 
CLVIRCON O0093 directly manage virtual storage, can be run without change 
CLVIRCON 00093 under control of VM/370, and thus utilize the facilities and 
CLVIRCON 00094 advantages of virtual storage. When an operating system 
CLVIRCON 00095 such as CMS, OS/VS 1, VS2, or DOE/VS (which can manage 
CLVIRCON 00096 virtual storage Via the Dynamic Address Translation facility 
CLVIRCON O0097 of a System/370) is run in a virtual machine, the stcrayd cf 
CLVIRCON 00098 the victual machine is itself managed as virtual storage. 
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CLVIRCON 00099 
CLVIRCON 00100 
CLVIRCON 00100 
CLVIRCON 00101 
CLVIRCON 00102 
CLVIRCON 00102 
CLVIRCON 00103 
CLVIRCON 00104 
CLVIRCON 00105 
CLVIRCON 00106 
CLVIRCON 00107 


The ainiaua victual storage size that can he specified fcr a 
user is 4K (4096 bytes or 1 page). The aaximua virtual 
storage size that can be specified is 16M (16,777,216 bytes 
or 4096 pages). Virtual storage size can be defined fcr any 
size between 4K and 16H in 4R increments. Each virtual 
aachine defined in the user directory has an "initial" ana a 
"aaxiauB" virtual storage size specification. The "initial" 
size is autoaatically assigned tc the user when he initially 
accesses the VM/370 system. The user can alter the size of 
virtual storage available to him up to his "maxima" by 
using the CP coaaand DEFINE. 


CLVIRCON 00108 
CLVIRCON 00110 
CLVIRCON 00111 
CLVIRCON 00111 
CLVIRCON 00113 
CLVIRCON 00114 


Virtual CP U: VN/370 provides a CPO resource to each active 
virtual aachine user through tine-slicing techniques. The 
virtual aachine can be single task or multi-task. Thus 
single or aultiple copies of CES, COS/360 and VS, CS/HFT, 
NVT, VS 1, VS2, PCP, and BPS and VH/37C can all run in 
concurrently executing virtual machines. 


CLVIRCON 00116 
CLVIRCON 00117 
CLVIRCON 00119 
CLVIRCON 00119 
CLVIRCON 00120 
CLVIRCON 00121 
CLVIRCON 00121 
CLVIRCON 00122 
CLVIRCON 00123 
CLVIRCON 00124 
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CLVIRCON 00125 
CLVIRCON 00127 
CLVIRCON O0128 
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CLVIRCON 00129 
CLVIRCON 00130 
CLVIRCON 00132 
CLVIRCON 00133 


Virt ual In put/ O utp ut: All virtual aachine I/O operations are 
initiated by the virtual machines operating system, but the 
channel programs involved are normally handled by Cl, which 
must translate thea into real machine I/O operations. This 
requires two translations acccapiished as fellows; CP 
intercepts all user 1/0 when STABTIO (SIO) is issued. It 
"naps" or converts virtual device addresses into real device 
addresses, translates virtual storace addresses into real 
storage addresses, ensures that all necessary pages are in 
real storage, builds the required channel prograa (tkat is, 
the appropriate nuaber of chancel ccaaand words) fcr the 
user, and issues SIO when the channel is free. The virtual 
aachine does not regain control frea CP frea the tiie it 
issues an SIO until CP issues the real SIO and delivers the 
resulting condition code to the virtual aachine.. In the 
aeantiae, other virtual aachines Bay be executing. When CP 
receives an interrupt indicating I/O coapleticn, it 
siaulates the proper I/O interrupt when control is returned 
to the virtual aachine. 


CLVIRCON 00134 
CLVIRCON 00135 
CLVIRCON 00136 
CLVIRCON 00137 
CLVIRCON 00137 
CLVIRCON 00139 


Physical DASD devices may be logically subdivided into 
saaller units called "minidisks" fcr the use cf virtual 
aachines; thus, when a virtual aachine user refers to a 
disk, he is actually accessing a portico of a physical disk. 
For example, a real 2314 pack may be divided into three 
virtual disks or "minidisks". 


CLVIRCON 00142 
CLVIRCON 00143 
CLVIRCON 00143 
CLVIRCON 00144 
CLVIRCON 00144 
CLVIRCON 09145 
CLVIRCON 091h6 


Virtual aachine unit record I/O is noraally spooled by CP 
onto a special spooling disk. Thus, any card deck to be 
"read" by a virtual aachine would, in the ncraal case, have 
been read in by CP before the user requests it fcr his 
virtual aachine, or it would have been transferred to that 
user froa another user's files. If the cards are tc be 
entered through the real card reader, the card deck aust be 
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CLVIRCON 

CLVIRCON 

CLVIRCON 

CLVIRCON 

CLVIRCON 

CLVIRCON 

CLVIRCON 

CLVIRCON 

CLVIRCON 

CLVIRCON 

CLVIRCON 

CLVIRCON 

CLVIRCON 

CLVIRCON 

CLBNVIR 


00147 preceded by a special VM/370 header card containing the 
00148 owner*s userid, so that Cp can know who owns the deck and 
00149 properly identify, label, and prcvide DASD storage space lor 
00149 the card-iaage file. Later, when the virtual aachine has 
00150 read the card inages, a card reader end-cf-file is 
00150 siaulated. Punch and printer output, eiailarly spooled, is 
00151 not queued for physical output until CP is notified of 
00153 end-of-file in one of three ways: 


00157 

00158 


the VB/370 user logs off the systea (end-of-file is 
assuaed), 


00161 

00161 

00163 


• the CP coaaand CLOSE; entered either explicitly, or 
iaplicitly by the CHS ccinands, PRINT and PUNCH; 
specifies the virtual address of the device to be cicsed. 


00165 * CP detects an invalid Channel Ccaaand Word (CCW) 

00166 addressed to the device (end-cf-file is assuaed). 


00169 Further output for a closed device is assumed to start a new 
00170 file. So that the systea operator can separate physical 
00170 output, VH/370 precedes all printed and punched output files 
00001 with a record containing the userid. 
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CLENVIR 
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CLENVIR 
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CLENVIR 
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CLENVIR 

00021 

CLENVIR 
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CLENVIR 
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CLENVIR 
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CLENVIR 

00028 

CLENVIR 

00029 

CLENVIR 

000 30 

CLENVIR 

00031 

CLENVIR 

00033 

CLENVIR 

00034 

CLENVIR 

00035 

CLENVIR 

00036 

CLENVIR 

00037 

CLENVIR 

00037 

CLENVIR 

00038 

CLENVIR 

00038 

CLENVIR 

00039 

CLENVIR 

00040 

CLENVIR 

00043 

CLENVIR 

00043 

CLENVIR 

00044 

CLENVIR 

00045 

CLENVIR 

00047 

CLENVIR 

00040 


VM/3 70 EN VIRONM ENT 


Each input line typed at the terminal fcy a usee is 
transmitted to the VM/370 system, where it is processed 
(examined, and accepted or rejected) ty a given routine. 
The particular routine by which input is processed is 
determined by which portion of the system has control at the 
time the input line is entered. Each portion of the system 
to which input nay be entered constitutes a unique 
environment, and only a subset of all possible input is 
acceptable to any given environment. Figure 1 shews the 
environments of the VM/370 system and shows hew each 
environment is entered. 

The input-processing routines fall into three main 
categories: input is received by either the Control Frcgram 

(CP environment), a central CMS service routine (CMS Command 
environment) , or a particular CHS command (CEBOG and EDIT 
environments)» Input lines which are acceptable to the CP 
and CMS environments are referred tc as commands. 

Certain CMS commands cause CMS sutenvironments to be 
entered. Examples of these are the LEBOG and EDIT commands. 
Lines acceptable to the environments of these commands are 
referred to as "subcommands”, or merely "input", depending 
on the particular mode which is entered when the command is 
issued. 

1) If the EDIT command is entered for a file which already 
exists, the EDIT mode is entered, allowing the cements 
of the existing file to be examined, added to, deleted, 
changed, or re-arranged. The user nay cause the input 
mode to be entered so that he can add to the existing 
file. 

2) If an EDIT command is issued for a file which dees not 
currently exist, the EDIT mede is entered, and. the user 
may cause the INPOT mode tc be entered so that he may 
directly create a file on dish, thus eliminating the 
keypunch step. The INPUT mode accepts any input typed 
at the terminal, and this input becomes a part of the 
file being created. Because no check is made to 
determine the . acceptibility of input to this 
environment, lines which are keyed in are termed 
"input". 

The ECHO environment is entered when the CP command ECHO is 
keyed in. All data lines entered in the ECHO environment 
are transmitted unchanged back to the terminal frem which 
they were received. 

To verify which environment the user is in, the RETURN key 
(or its equivalent) can be depressed with no characters 
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CLENVIR 
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CLENVIR 


00049 


entered. 


00050 

00051 

00052 

00053 

00054 


Various actions by the user cause ccntrol to pass iron one 
environaent to another. These actions are specified in 
detail throughout this guide. The Attention Key (or its 
equivalent) can always be used tc transfer ccntrcl tc the CP 
environaent froa any of the other environaents. 
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Figure 1. VH/370 Environaents 
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00009 

CLPILN 

00010 

CLFILM 

00011 

CLFILM 

00012 


CLFILM 

00015 
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00031 
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CLFILM 

00034 


cis Hu aMAsmsi 


The Conversational Monitor Systen (CMS) uses a specially 
designed file aanageaent scheae tc manipulate and cairtain 
user and systea data files on direct access storage devices 
(disks). 

Mate: The teras "user disk", "disk", and "disk space" are 
used in this discussion to denote virtual disks rather than 
physical disks. 


DISK ARRANGEMENT 


Each user has access to a aaxiaua or nine user disks plus 
the CMS Systea disk, which is shared among all users. Each 
user disk has a naae in the fora of a six character label 
associated with it. within the defined disk space, records 
are automatically allocated on demand whenever a CMS file is 
to be created or expanded. Whet a COS file is deleted the 
space originally occupied by the records cf the file is 
autoaatically returned to "available" status. CMS disks are 
pre-foraatted into 800-byte physical blocks; logical records 
are defined within these fixed-length physical blocks. £acn 
disk space has an index or directory which lists the 
contents (files) or that disk and contains pointers tc the 
800-byte blocks which constitute the files cn the disk. 
Blocks of a single file need net be contiguous. 


A user file directory is created for each disk the user aay 
refer to. This directory contains a pointer tc a File 
Status Table (FST) for each file on the disk. The FSI 
refers to a field which contains a record of where the 
800-byte data blocks for the file are located on the disk. 
Figure 2 shows the relationship between these lteas. 
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Figure 2. CHS Disk File Structure 
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Each of the nine user file directories and the systen disk 
file directory has a nane in the forn of a single alphabetic 
character. A, B, C, D, E, F, G, S, Y, or Z. When a user 
reguests that a disk be nade available to his systen, he 
assigns a nane to the directory cf that disk. The 'S' 
directory denotes the systen disk. 


CLFILH 00081 


Oisjp fij&£H2i2HS 


CLFILH 00082 
CLFILH 00083 
CLFILH 00083 
CLFILH 00085 
CLPILH 00086 


A file directory, in addition tc encoapassing the files cf 
the disk which it directly represents, iay logically be used 
to refer to the disk files of another disk. The latter 
directory is referred to as an extension cf the tenner 
directory, with the former known as the parent directory. 
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FILE NAMING 


^0091 

00092 

00092 

00093 

00094 


Each file created under CMS 
CMS coaaands, is represented 
user refers to the file, 
three coaponents—filenaae, 
following foraat: 


contrcl cr created for use by 
by a file identifier by which a 
A file identifier consists of 
filetype, and fileacde, in the 


00097 


filenaae filetype filcaode 


00101 

00103 


filenaae is a one to eight alphaneric character naae 
fn assigned (in aost cases) by the user. 


00106 

00108 

00109 

00110 

00111 


filetype is a one to eight alphaoeric character naae 
ft used as a descriptor cr as a qualifier cf the 

filenaae. Befer tc "Appendix C: heserved 

Filetype Descriptions" for restrictions 
concerning the assignaent of a filetype. 


00114 

00116 

00116 

00116 

00117 

00118 


fileaode is a two character field. The first character 
fa is alphabetic and denotes the naae cf the file 

directory of the disk on which the file resides. 
The second character is cuaeric and denotes the 
aode by , which the file is accessed. Valid 
access Bodes are shown in Figure 3. 
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j NODE 

| SEAMING| ACCESS ALLOWED 
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I o 

1 r 1 

| private| file is accessible only 
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1 


| when the directory is used in| 
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1 


| read/write status. 
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1 1 

1 R/W 

1 file is accessible in read/ 
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j write status ocly if the 
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j directory is in read/write 
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j status. 


00137 

j 2 

| H/O 

j file cannot be aoditied 


00138 
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) in place. 


00139 

1 3 

1 B/B 

I file will be erased after it 


00140 

1 


j is read. 


00141 

1 4 

| OS 

| file is in the foraat pro- 


00142 



j duced by the siaulated OS 


00143 
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| access aethods under CHS. 


00144 

| 5 

1 B/H 

1 saae as Node 1. 


00145 
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i_ 
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Figure 3. Access Nodes for CHS files 
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00158 DIRECTORY SEARCH CRITERIA 


00159 

00160 

00161 

00162 

00162 

00163 

00164 

00164 

00165 


When a CHS virtual nachine is capable of using two cr nore 
file directories, a problea cf search order arises. If, in 
a specific CHS coanand, the user has the ability ct 
designating which directory to exanine foe the file, there 
is no doubt as to where and how to search directories. But 
in soae cases, if the user does not cr cannot designate a 
directory, there aust be a set search pattern for scanning 
directories to find a specified data file or available disk 
space. 


00167 




00168 

00169 

00170 


To find a file, or space for writing a file, the user disks 
are searched in a systea-defined alphabetical order: A, B, 
C, D, E, F, G, S, 7, and Z• 


00171 When one file directory is aade an extension of another 
00173 directory by the CHS connand ACCESS, the extension directory 
00173 is searched inaediately after tte parent. Thus, the 
00174 standard search order nay be changed for the duraticn of the 
00175 terainal session. 


00177 fileaaiS 2£££iJi£ati£B 


00179 The fileaode for a particular file nay be indicated in one 

°0180 of the four ways shown in Figure 4. 

00188 
00189 
00190 
00191 
00192 
00193 
00194 
00195 
00196 
00197 
n 0198 
00199 

00202 Figure 4. Hethods of Fileaode Specification 

00208 The following rules have been established tc govern the 

00209 action of all coaaands relative tc the four aetheds of 

00209 specifying the fileaode (fa; *, «; blank; null) and the two 
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possible 

access nodes (Bead# Write). 

CLPILN 

00213 

Beading: 


CLFILN 

09216 

£■ 

when a node designation such as E2 cr E is 

CLFILN 

09216 


specified within the ccaaand line# the unique 

CLFILN 

00217 


file directory and all its extensions are 

CLFILN 

00217 


searched. If the specified directory is itself 

CLFILN 

00219 


an extension# its parent is not searched. 

CLFILN 

00221 

default 

if the coaaand entered does not contain a 

CLFILN 

00222 


fileaode (that is# the user chooses to leave the 

CLFILN 

00223 


filenode specificaticn blank)# the disk with a 

CLFILN 

00224 


node designation of is searched. 

CLFILN 

00226 

*,null 

a search is aadfe of all active disks in the 

CLFILN 

00227 


predeternined# hierarchical order. 

CLFILN 

00230 

Writing: 


CLFILN 

00232 

fa 

when a node designation such as A1 cr A is 

CLFILN 

00233 


specified# that unigce disk is written upon. If 

CLFILN 

00234 


the specified aode letter designates a read/only 

CLPILN 

00235 


disk# the coaaand abcrts. 

CLFILN 

09237 

= 

0 

when "=" is entered# it is used fcr ccatands 

CLFILN 
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which have read/wtite functions to indicate 

CLPILN 

00238 


that writing should be done tc the disk frca 

CLFILN 

00239 


which the reading tock place. 

CLFILN 

00242 

default# 

for coaaands with read/write functions# writing 

CLFILN 

00243 

null#* 

is atteapted to the disk cr the parent cf the 

CLFILN 

00244 


disk froa which reading was done. If no roca is 

CLFILN 

00245 


available on either cf the disks aentioned cr if 

CLFILN 

00246 


both disks are read/only# writing is done only 

CLFILN 

00247 


to the priaary disk* 

CLPILN 

00250 

"Appendix 

C: Disk Deteraination” presents a table relating 

CLPILN 

00251 

CNS coaaands# aethods of fileacde specification, and the 

CLFILN 

00252 

criteria 

used in choosing a file directory fcr reading and 

CLFILN 

00253 

writing. 
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BESEHVED FILETIPES 

CLFILN 

09258 

Filetype (ft) is an eight alphaceric character coapcnent cf 

CLFILN 

00259 

the CHS file identification and is used a filenaae 

CLFILN 

09269 

descriptor or qualifier* For certain ccnaands in which cnly 

CLFILN 

09261 

a filenaae nay be issued# CNS assumes a filetype for the 

CLFILN 

09262 

specified filenaae. 

CLFILN 

00263 

"Appendix D: Beserved Filetype Descriptions" contains a 
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sumac y of filetypes which have special significance tc the 
CHS systea. 
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CLCHARST 

CLCHARST 

CLCHARST 
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00009 


CH ARAC TER SET USAGE 


00011 CP and CHS coaaands aay be entered using a coibinaticn of 
00012 characters froa six different character sets. The ccntents 
00013 of each of the character sets is described in Figure 5. 
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Figure 5. Character Sets 
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00005 NA MING CONV ENTIONS 


00009 

OOOIt 


1 . 


Ail coaaand naaes, keyword parameters, filenames, and 
filetypes aust aeet the following requirements: 


00016 


a. All characters Bust be alphaaeric. 


00018 

00019 

00020 

00021 


b. The length of each field aay not exceed eight 
characters. If the field exceeds eight characters, 
it is truncated without any indication to the 
user • 


00024 2* Passwords and userids aay be any coabinaticn cf up to. 
00025 eight characters, including all nuneric and special 
00026 characters. 

00028 3. Foluae serial labels aay be any conbinaticn cf up to 
00029 six alphaaeric characters. 

00031 4. No naae can contain a character noraally used by Vfl/370 
00032 for logical line-editing as discussed in n Appendix B: 
00032 Terainal Considerations'* in the discussion cf Line 
00033 Bditing 
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CLCOMSYN 


CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 


CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 


CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 

CLCOMSYN 


00006 


COMMAN D SYNTAX 


00009 
00009 
00010 
00010 
00011 
00012 
00013 
000 13 
00014 
00016 
00016 
00018 
00019 
00019 
00021 
00022 
00023 
0 0024 


A coaaand line consists of a ccaaand naae, usually tcllcwea 
by one or aore positional operands, and possibly by an 
option list. A coaaand naae is typically a faailiar English 
word, usually a verb, that describes the function oi the 
coaaand. The positional operands provide specific 
inforaation required for the coaaand to perfcra the 
requested operation. The option list begins with a left 
parenthesis and indicates which coaaand opticas arc to be 
used. The right or closing parenthesis is cpticnal and nay 
be oaitted if no other inforaaticn is to be entered. The 
user aay enter a left parenthesis and a carriage return 
which signals that default opticns are in effect. This is 
equivalent to ending the inpuf line after the positional 
paraneters. However; in the SON ccaaand, it he enters a 
left parenthesis followed by a carriage return, null 
argunents will be assuaed; in COEYFILE and FILEDEF ccaaands, 
an error nessage will be generated. The general ccaaand 
format is as follows: 


00C35 

00036 

00037 


| coaaand naae | [operands... * [(options...[) *] | 

i.......i 


00042 

00043 

00046 

00048 

00050 


For exaaple, to asseable a source file naaed TEST ana print 
the listing, type 

ASSEMBLE TEST (PRINT) 

- or - 

ASSEMBLE TEST (PRINT 


00055 

00055 

00056 

00057 

00058 

00059 

.00060 

n 0063 

00065 


Coaaand paraaeters nust be separated frea one ancther by one 
or aore separator, characters (blanks) and the ccaaand naae 
aast be separated froa the first paraaeter by cue or aore 
blanks. Any paraaeters entered ether than these required are 
treated as coaaents. See Notes 1 through 3 belcw for 
exceptions to this. There are t»c types cf ccaaand 
paraae ters: 


2 . 


Positional paraieters 
Keyword paraaeters 


00068 


POSITIONAL PARAMETERS 


00070 

00071 

00073 

00074 

00075 


Positional paraaeters aust be entered first in the paraaeter 
string, and they aust be in a specific erder. 

For the purpose of syntax checking, positional paraaeters 
are divided into paraaeters that include deliaiters as part 
of their definition (deliaiter-dependent paraaeters) and 
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CLCONSTN 

00076 

CLCONSTN 

00077 

CLCONSTN 

00080 

CLCONSTN 

00082 

CLCONSTN 

00083 

CLCONSTN 

00083 

CLCONSTN 

00084 

CLCONSTN 

00086 

CLCONSTN 

00087 

CLCONSTN 

00088 

CLCONSTN 

00089 

CLCONSTN 

00094 

CLCONSTN 

00095 

CLCONSTN 

00097 

CLCONSTN 

00099 

CLCONSTN 

00100 

CLCONSTN 

00102 

CLCONSTN 

00103 

CLCONSTN 

00105 

CLCONSTN 

00106 

CLCONSTN 

00107 

CLCONSTN 

00108 

CLCONSTN 

00110 

CLCONSTN 

00111 

CLCONSTN 

00111 

CLCONSTN 

00112 

CLCONSTN 

00113 

CLCONSTN 

00114 

CLCONSTN 

00115 

CLCONSTN 

00116 

CLCONSTN 

00119 

CLCONSTN 

00121 

CLCONSTN 

00122 

CLCONSTN 

00124 

CLCONSTN 

00126 

CLCONSTN 

00126 

CLCONSTN 

00127 

CLCONSTN 

00129 


parameters that do sot include delimiters as part c£ their 
definition (deliaiter-independent paraneters). 

fifiiilii5£_De£end2Bt_£a£aaeteis 

Those paraaeters that include delimiters as part cf their 
definition are called deliaiter-dependent paraaeters. 
Delia!ter-dependent paraaeters used in the coaaand language 
are: 

1. FILEID 

2. STRING 

3. SSTNBOL 

4. LABEL 

FILEID 

A fileid consists of all the inforaation necessary to 
uniquely identify a file. The format is as fcllcwe: 

fn ft fa 

filename (fn) is the user-supplied nane of the file. 
The filenaae aay be up to eight alphaaeric characters. 

filetype (ft) is a descriptive gualifier fer the file. 
It aay be up to eight alphaaeric characters. 

filenode (fa) specifies in which logical directory tne 
file exists, and the node by which the file nay be 
accessed. 

An asterisk or an equal sign aay be used in sone 
coanands in place of fn, ft, or fa. An asterisk 
indicates that all files at that level are tc be 
considered. For exaaple, "fn * fa" means that the 
specified function is to be performed for all files 
with the given fn and fa. An equal sign indicates that 
the naae is to be the sane as the previously entered 
name at the sane level. 

STRING 

A string is a group of* characters between two alike 
self-defining delimiter characters, such as 

/string/ 

or, the group of characters between a self-defining 
delimiter character and the end cf a logical line, such 
as 


/string 
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CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 


CLCOMSYH 


CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 

CLCOMSYH 


00131 The same self-defining delimiter character can be used 

00132 to delimit two contiguous strings, such as 


00134 /string/string/ or /£tring/string 

00135 A null string, which indicates that a positional 

00136 pacaaeter has not been entered, is defined as two 

00137 contiguous delimiters or a delimiter and the end cf a 

00138 logical line. 

00141 SSYMBOL 


00142 

00143 

00144 

00145 

00146 

00147 

00148 

00149 


A special symbol (SSYMBOL) consists of an ampersand 
followed by up to seven alphameric charactes. An 
SSYMBOL nay be either an argument number or a symbolic 
name. An argument number ccnsists of an ampersand 
followed by an integer frcm 0 tc 255. A symbolic name 
consists of an ampersand followed by up to seven 
alphameric characters, the first cf which must be an 
alphabetic or national character. 


00153 LABEL 


00155 A label consists of up to sever characters preceded by 

00156 a dash, such as 


00158 -labell 

00162 Delimi ter-Inde pe nden t P arame ters 

00164 A positional parameter that is not dependent on delimiters 

00165 is treated as a character string. It may consist cf any 

00166 characters except a blank or carriage return. 


00168 KEYWORD PARAMETERS 


00170 Keyword parameters are specific names or symbols that have a 
00171 particular meaning to the system. Keywords may be ceded in 
00173 any order within the command field in which they are used. 

00174 Keyword parameters can have other parameters associated with 
00175 them. These parameters, knewr as subfields, must be 
00176 separated from the keyword by a blank, A typical keyword 
00177 with a subfield is: 

00180 LINBCHT 55 
00182 keyword subfield 

00184 Hote J: Except where noted, extranecus information entered 
00185 in a CP command line after any required operand or selected 
00186 options is treated as a comment. 
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CLCOHSTN 

CLCOHSTN 

CLCONSYN 

CLCOHSYN 

CLCONSYN 

CLCONSYN 

CLCONSYN 

CLCONSYN 

CLCOflSYN 

CLCOflSYN 

CLCONSYN 

CLCONSYN 

CLCONSYN 

CLCONSYN 

CLCONSYN 

CLCONSYN 

CLCONSYN 

CLCOHSTN 

CLCONSYN 

CLCONSYN 

CLCOHSTN 

CLCOHSTN 

CLCONSYN 

CLCOHSTN 


00187 

The following 

C? coaaands will not accept cosaents in the 

00188 

couand line 

due to 

the structure or 

function c£ the 

00189 

coanand. Any extraneous 

indorsation will 

be rejected with an 

00191 

error aessage. 




00194 

ACNT 

ENABLE 

SPOOL 


00195 

BACKSPAC 

FLUSH 

STAHT 


00196 

CHANGE 

IPL 

STCP 


00197 

CLOSE 

LOADBUF STOBE 


00198 

DCP 

MSG 

TEBHINAl 


00199 

DISABLE 

ORDER 

TRACE 


00200 

DISPLAY 

PURGE 

SNG 


00201 

DHCP 

REPEAT 

« 


00202 

DUMP 




00206 

Note 2: In CMS coaaands 

if, after all 

possible positional 

00207 

parameters are 

entered, 

text is entered 

that is not a left 

00208 

parenthesis ^indicating 

options5, an 

error aessage is 

00209 

generated e 




00211 

Note 3: In CHS coaaands 

, consents nay te 

entered after the 

00212 

right parenthesis which 

indicates the end 

of the option list 

00213 

except in the 

ERASE coaaand, where no consents are allowed. 

00215 

Mote 4: If conflicting or duplicate options are specified in 

00216 

CHS coaaands. 

the last 

one entered is in effect except in 

00217 

the following coaaands: 



00220 

COFTFILE, 

BRASS, FILEDEF, FCBHA1 
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CLNOTCON 

00009 

CLNOTCON 

00011 

CLNOTCON 

00013 

CLNOTCON 

00016 

CLNOTCON 

00017 

CLNOTCON 

00C18 

CLNOTCON 

00018 

CLNOTCON 

00019 

CLNOTCON 

00023 

CLNOTCON 

00025 

CLNOTCON 

00029 

CLNOTCON 

00"30 

CLNOTCON 

00031 

CLNOTCON 

00032 

CLNOTCON 

00033 

CLNOTCON 

00034 

CLNOTCON 

00035 

CLNOTCON 

00036 

CLNOTCON 

00037 

CLNOTCON 

00038 

CLNOTCON 

09039 

CLNOTCON 

00041 

CLNOTCON 

00042 

CLNOTCON 

00043 

CLNOTCON 

00049 

CLNOTCON 

00050 

CLNOTCON 

00051 

CLNOTCON 

00053 

CLNOTCON 

00054 

CLNOTCON 

00055 

CLNOTCON 

00056 

CLNOTCON 

00057 

CLNOTCON 

00062 

CLNOTCON 

00063 

CLNOTCON 

00064 

CLNOTCON 

00066 

CLNOTCON 

00067 

CLNOTCON 

00068 

CLNOTCON 

00069 

CLNOTCON 

00070 

CLNOTCON 

00071 


j&Zm&BAI' £m£JB£l£jiS 


The notation used to define the ccsirand syntaa in this 
publication is described in the following paragraphs: 

1* Miniaua truncation and abbreviation 

Coaaand naaes aa*y be specified by typing any part ct 
the naae from the ainiaua truncation to the full case. 
The ainiaua truncation, if any, is noted below the full 
nane of the coaaand. 


Exaaple: ASSEMBLE 

A 

indicates that A, AS, 
ASSEHBL, and ASSEMBLE are 
this coaaand naae. 

Options aay be specified in 
truncation, if any, is not 
each option of a pacticul 
truncation is noted, the en 


ASS, 

ASSE 

, ASSEM, 

ASS 

EM 

B, 

all 

valid 

specificati 

COS 

f 

cr 

the 

sane 

manner. A 

■ ID 

ia 

ua 

ed belcv t 

he explana 

tic 

n 

cf 

ar ccaaand 

. If nc 

■ in 

IB 

ua 

tire 

werd 

aust be entered. 



A second series of characters below the coiaand naae or 
option indicates that an abbreviation, (that is, a 
collection of characters which is net a siaple 
truncation) is also valid. 

Exaaple: BEADEH nane 

B ainiaua truncation 

BDB valid abbreviation 

i 

2. The following synbols are used tc define the coaaand 
foraat and should never be typed when the actual 
coaaand is entered. 

underscore _ 
braces ( ) 

brackets [ ] 

ellipsis ... 

logical OB | 


3. Uppercase letters and words, and the synbols listed 
below, should be typed as specified in the stateaent 
foraat. 


asterisk 

coaaa 

hyphen 

egual sign 

parentheses 

period 




( ) 
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CLNOTCON 

00C72 

CLNOTCON 

00077 

CLNOTCON 

00078 

CLNOTCON 

00079 

CLNOTCON 

00080 

CLNOTCON 

00083 

CLNOTCON 

00085 

CLNOTCON 

00087 

CLNOTCON 

00088 

CLNOTCON 

00089 

CLNOTCON 

00092 

CLNOTCON 

00093 

CLNOTCON 

00094 

CLNOTCON 

00095 

CLNOTCON 

00100 

CLNOTCON 

00101 

CLNOTCON 

00102 

CLNOTCON 

00106 

CLNOTCON 

00107 

CLNOTCON 

00107 

CLNOTCON 

00108 

CLNOTCON 

00111 

CLNOTCON 

00111 

CLNOTCON 

00112 


CLNOTCON 

00116 

CLNOTCON 

00117 

CLNOTCON 

00118 

CLNOTCON 

00123 

CLNOTCON 

00125 

CLNOTCON 

00126 

CLNOTCON 

00127 

CLNOTCON 

00130 

CLNOTCON 

0H132 

CLNOTCON 

00135 

CLNOTCON 

00140 


colon : 

4. Lowercase letters, words, and syafcols appearing in the 
coaaand foraat represent variafcl.eE for which specific 
inforaation should be substituted. For exaaple, N in ft 
fa" could be typed in as "M1FILE EXEC A1." 

5. There are two ways that choices are represented in the 
coaaand foraats. One i*a by stacking then: 

A 

0 

C 

The other is by separating then with logical OR 
characters. 

AjB|C 

6. Punctuation aarks joining lowercase letters, words, and 
symbols indicate that only one value is to be 
substituted for the variable. 

Exaaples: 1. If "record-length" appears in a 

coaaand definition, only one value 
should be substituted (fer exaaple, 
20 ) . 

2. If "n'cyl" appears in a coaaand 

definition, cnly one value shculd be 
substituted (for exaaple, 5). 


7. An underscore indicates an ' assuaed default option. If 
an underscored choice is selected, it need not fce typed 
when the coaaand is entered. 

Exaaple: The representations 

A 

a or A|gic 
c 

indicates that either A, fi, cr C nay fce selected. 
However, if 0 is selected, it need not be specified. 

8. The use of braces denotes choices, one of which B ust be 
selected. 
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CLNOTCON 

CLNOTCON 
CLNOTCON 
CLNOTCON 
CLNOTCON 
CLNOTCON 

CLNOTCON 

CLNOTCON 

CLNOTCON 

CLNOTCOH 

CLNOTCON 

CLNOTCON 

CLNOTCON 

CLNOTCON 

CLNOTCON 

CLNOTCON 

CLNOTCON 

CLNOTCON 

CLNOTCON 

CLNOTCON 

CLNOTCON 

CLNOTCON 

CLNOTCON 

CLNOTCON 

CLNOTCON 


00144 


Exaaple: 


The representations 


00147 

00148 

00149 

00150 

00151 


r i 
I A | 

< B > or {A|B|C) 
I C | 

L i 


00155 

00155 

00159 


indicate that the user Bust specify either A, B, cr C. 
If a list of choices is enclosed by neither brackets or 
braces, it is to be treated as if enclosed by braces. 


00162 9) The use of brackets denotes choices, one cf which aay 

00163 be selected. 


00172 


Exaaple: The representatiocs 


00174 
00175 
00176 
00177 
0 0178 


d 

r i 

e a t 

J B | or [ A | B | C ] 
I C | 

«. j 


00181 

00182 


indicate that the user nay code A, E, or C, cr he aay 
oait the field. 


00186 10. An ellipsis indicates that the preceding itea or group 

00188 of iteas aay be repeated aore than cnce in succession. 


00190 


Exaaple: The representation 


00192 (option...) 

00195 indicates that aore than one optics aay be coded within 

00196 the parentheses. 



29 



IBB CONFIDIN1IAL 


CLLOGON 


CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 


CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 


CLLOGON 


CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 


00005 




00007 

00008 

00009 

00009 

00010 

00O10 

00011 

00012 

00012 

00013 


This section describes the procedures which aust te 
performed at the terminal to begin and terminate use ct the 
VM/370 system. Before the VK/37C facilities are made 
available to a user, he must identify himself to the control 
program (CP) by giving his userid and his password (two 
identifiers which are assigned to him at the time he is 
authorized to use the system). This identification 
procedure is referred to as login, when Login is completed, 
a command may be issued to initialize CBS, as described 
below. 


00014 

00016 

00016 

00018 


When the user has completed his use of the system, he 
signals this fact by issuing a LOGOUT command to CP. The 
interval of time between VB/370 Login and VB/370 Logout is 
referred to as a terminal session. 


00019 

00021 

00022 

00022 

00023 


No£e: During the Login procedure, CP uses the teleprocessing 
line time-out feature when reading the userid and password. 
If a user fails to type any character for a specified length 
of time (normally 28 seconds), the line will time-out and be 
disabled. 


00025 


Login Procedure 


00026 After the terminal has been prepared for use as described in 
00028 -the £§£ litiual N§£bi&e 

00030 (Order Mo. GC20-1810) the procedure described below aust be 
00030 performed in order to gain access to the VB/370 system. 
00032 (Input may be entered in either uppercase or lowercase). 


00035 

00036 


A communications link tc the computer aust be 
established as described in the Terminal Oser's Guide. 


00038 

00039 

00040 


2. The system acknowledges that a communication line has 
been established by typing one of the following 
messages: 


00043 


va/370 online xxxxxxix 


00045 


00047 


xxzxxxxxx va/370 online 


0 00 4 8 The xxxxxxxx portion of the message consists cf 

00049 meaningless characters and should be ignored. The 

00050 message types in lowercase letters. 
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CLLOGON 

CLLOGON 

"LLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 

CLLOGON 


CLLOGON 

CLLOGON 

CLLOGON 


00055 

00056 

00057 


3. At this point, the systen arst be notified that soaeone 
wishes to use it. To do this, the user Bust press the 
ATTN key (or its equivalent) once. 


00059 

00060 

00061 

00062 


4. The systen responds by unlocking the keyboard on an IBM 
2741 or 1052, or waiting for input cn the Teletype* 
Model 33 or 35. On the Teletype terninals, a period (.) 
is typed. 


00065 

00065 

00067 

00067 

00069 


5. The user then identifies biaself tc CP by using the 
LOGIN coaaand. Befer to the CP Ccnaand Secticn fcr a 
description of the various foras c£ the LOGIN coaaand. 
If the user has entered the ccaaand naae incorrectly, 
one of the following aessages will type: 


00071 

00073 

00076 

00077 

00078 

00079 

00082 6. 
00083 


restart xxxxxxx 
-or- 

xxxxxxx restart 

The xxxxxxx portion of 
aeaningiess characters and 
should repeat Step 5. 

If the LOGIN coaaand has 
systea responds with one o: 


the aessage consists cf 
should be ignored. The user 


been entered correctly, the 
the following aessages: 


00085 ENTEH PASSWORD: ENTER EASSNOBt: 

00086 -or- 

00087 llllllll 


00088 

00089 


where INIIIIII is a nask to safeguard the user's 
password. 


00092 


7. The first fora of the above aessage is received if 


00098 

00098 

00100 


a. the user's terainal is an 1BK 2741 with the Print 
Inhibit feature. The user should enter his 
password; it does not print as he is typing it. 


00103 

00103 

00104 

00105 

00105 

00106 


b. the user did not specify the MASK cpticn in the 
LOGIN coaaand. The user should press the Carriage 
return key (or its equivalent) to indicate that he 
wishes the nask to type. The Bask then types and 
the user should enter his password ever the 
printed nask. 


0<>113 

00115 * Teletype is a tradeaark of the Teletype Corporation, 

00116 Skokie, Illinois. 
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CLLOGON 

00118 

CLLOGON 

00119 

CLLOGON 

00121 

CLLOGON 

00125 

CLLOGON 

00126 

CLLOGON 

00132 

CLLOGON 

00134 

CLLOGON 

00136 

CLLOGON 

00137 

CLLOGON 

00139 

CLLOGON 

00141 

CLLOGON 

00143 

CLLOGON 

00145 

CLLOGON 

00147 

CLLOGON 

00148 

CLLOGON 

00149 

CLLOGON 

00152 

CLLOGON 

00154 

CLLOGON 

00156 

CLLOGON 

00158 

CLLOGON 

00159 

CLLOGON 

00160 

CLLOGON 

00161 

CLLOGON 

*0163 

CLLOGON 

00164 

CLLOGON 

00165 

CLLOGON 

00169 

CLLOGON 

00170 

CLLOGON 

00171 

CLLOGON 

00173 


CLLOGON 

*0176 

CLLOGON 

00177 

CLLOGON 

00179 

CLLOGON 

**181 

CLLOGON 

00182 

CLLOGON 

00183 

CLLOGON 

00184 

CLLOGON 

00184 

CLLOGON 

00185 


The second foci of the message is typed if the usee 
specified the MASK option in the LCGIN command. The 
user should type in his password over the printed mas*. 

8. If the password entered contains no errors, one cr more 
of the folowing messages types out: 


a. LOGMSG 

b. LOGMSG 
C. FILES 

d. LOGON 


setup time 

messages with * as the first character 
messages (describing status of any virtual 
unit record files) 

LOGON time message 


If any message other than one of the above types prints 
out, the user should proceed to step 9. 


Explanation of messages received at LOGON time: 

a. If the VM/370 operator has previously set up any log 
messages preceded by an asterisk (*), they are 
automatically typed at this time. For example: 

LOGMSG 09:34:54 02/15/72 

*CP HILL BE UP 24 HOOFS A CAT 

♦QDEBY LOG FOB ADDITIONAL 1NFOBHATICN 

Lower priority log messages may be present in the 
VM/370 system, which do not have the preceding 
asterisk. In order to see the additional entries, 
the user must type the command: 

QUEBY LOGMSG 

This results in the typing cf all leg messages 
including * messages. 

b. At this time, if there are any files in the 
virtual reader, or cutput files for the printer 
or punch, the message: 

FILES: xxx BDB, xxx PET, xxx FUN is typed. 


c. The system then responds with the following 
message: 

LOGON AT hh:mm:ss zone weekday mm/dd/yy 

where hh:mm:ss is the time of day, zone is the 
time zone (for example, EST), weekday is the day 
of the week, and mm/dd/yy is the date. This 
message indicates that the password has been 
accepted and the VE/370 LCGIN procedure is 
complete. The ccnircl picgram (CP) environment 
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00186 

00186 

00187 


has been entered, and any CP coaaand say be 
issued* To load CMS into the user's virtual 
aachine, proceed to step 11. 


00193 

00194 


9. 


Sone of the reasons why VM/37C nay reject a user's 
request for access to VM/37C are: 


00201 

00204 

00207 

00209 

00212 

00213 

00216 

00218 


• An invalid password was given. 

• The userid is already being used by sciecne else. 

• An invalid userid or no Gserid was given. 

• The specified userid is not in the directory. 

• VH/370 is already servicing the aaziaua nuaber of 
users. 

• An error occurred while the directory entry for the 
specified user was being read. 


00220 

00221 

00223 


If the user receives a message indicating that any of 
the above error conditions has occurred, he should take 
appropriate action as indicated by the aessage. 


00227 

00228 

00228 

00229 

00230 


Any operating systea can now be loaded intc the virtual 
nachine. To load CMS, the user should proceed tc step 
11. To load another operating systea, the IPL coaaand 
should be issued to CP, specifying the device froa 
which the systea is »to be leaded. For exaaple: 


00232 


IPL 293 


00234 


-or- 


00236 


IPL 00C 


00237 

00238 

00239 


If the device that is IELed contains an operating 
systea (such as OS or DOS) the renote terainal beccaes 
the operator's console for that operating systea. 


CO 242 


11. CMS Initialization 


00246 

00247 

00248 


a. To initialize CMS, one of the following icras of 
the IPL coaaand aust be issued, followed by a 
carriage return (or its equivalent). 


00250 


IPL ecu 


00252 


-or - 


00254 


IPL CMS 


00255 

00257 

00258 

00258 

00259 


This causes a copy cf the CMS nucleus to be 
brought into storage fcca disk. The first fera cf 
the coaaand indicates that the CMS nucleus is to 
be retrieved frea the device at virtual device 
address ecu. 
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b. The aessage: 


00264 


CHS Vx. y na/dd/yy hhioaiss 


00265 

00266 

00266 

00268 


is typed, where x is the version level and y is 
the modification level, and the keyboard is 
unlocked* The CMS Coaaand environaent has control 
at this point, and any CMS coaaand aay be issued* 


00271 


Lo gout ££2£fi4il£SS 


00272 

00273 

00274 

00275 

00276 

00276 

00278 


Hhen the user has finished using the system and wishes to 
end his terminal session, he should do so by logging out 
froa CP. If the user is not already in the CP environaent 
at the tiae he wishes to leg out, he aay enter this 
environaent by pressing the ATTN key (or its equivalent) 
twice. The keyboard is unlocked and the user types LOGOUT, 
followed by a carriage return. The system responds with 


00280 

00282 


CONNECT=hh:aa:ss VIRTCPU=aa :ss, hs TOTCEU=hb :ss .hs 
LOGOFF AT hh:nn:ss zone weekday an/dd/yy 


00286 

00287 

00287 

00288 

00289 

00290 


and the connection to the coaputer 
switched line. The connect tiae is in 
seconds; the virtual CPU, and total 
ainutes, seconds, and hundredths of a 
procedure is then completed, and the 
terainal power off. 


is broken if on a 
hours, ainutes, and 
CPU tines are in 
second. The logout 
user aay turn the 


00291 If the user desires to end the terainal session, tut not 
00292 lose the switched line connection with the coaputer (sc that 
00293 another user aay log in from 'the terainal) , he types 


00296 


LOGOUT HOLD 


00299 If the word HOLD is keyed in followed by pressing the BETUHN 
00301 key (or its equivalent), CP does not disconnect the terainal 
00301 froa the fM/370 coaputer, but will type cut the M va/370 
00001 online** aessage again as in Step 2 of the login procedure. 


00006 




00007 Figaros 6 through 14 present a functional sunaary of 
00009 commands available in the VH/370 systea. They are described 
00010 in detail in the following sections. 
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CLFONCSR 

00627 

I Defer spooled output of a 

1 

1 




CLFONCSR 

00628 

i particular user. 

| HOLD 

1 



CP 

CLFONCSR 

00629 

1 

j 

j 




CLFONCSR 

00630 

j Load printer 0C5 or FCB 

S 

I 




CLFONCSR 

00631 

; buffer. 

| LOAIEUE 

1 



CP 

CLFONCSR 

00632 

a_ 






CLFONCSR 

00634 

$ 

Figure 13. Coneands for Spooling Ccntzcl 
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CLFUNCSM 

CLPUNCSM 

00638 

00639 

i- 

1 

1 

1 

. 


-— 

■1 

CLFUNCSM 

00640 

1 FUNCTION 

| COMBINE 


SUE- 


TYPE 


CLFUNCSM 

00641 

1 

1 

1 

COMMAND, 




clfuncsm 

00642 

1 

1 

1 

OPTION 





0 0643 

I . -- -.-.- .. .- — 

■ 






CLPUNCSM 

00644 


i 

1 





CLFUNCSM 

00645 

| Cause spooled files to be 

i 

1 





CLFUNCSM 

00646 

| processed in a specific 

i 

1 





CLFUNCSM 

00647 

1 order. 

| CEDED 

1 



CP 


CLFUNCSM 

00648 

\ 

1 

1 





CLFUNCSM 

00649 

I Reaove closed spool files 


1 





CLPUNCSM 

00650 

| froa the sysiea. 

| PURGE 

1 



CE 


CLFUNCSM 

00651 

! 

i 

1 





CLFUNCSM 

00652 

| Request inforeation about 


1 





CLPUNCSM 

00653 

j spool files. 

| QUERY 

1 



CP 


CLFUNCSM 

00654 

1 

i 

1 





CLFUNCSM 

00655 

j Repeat printing or punching 

1 

1 





CLFUNCSM 

00656 

I of current file on a 

1 

1 





CLFUNCSM 

00657 

| specific output device. 

| REPEAT 

1 



CP 


CLFUNCSM 

00658 



1 





CLPUNCSM 

00659 

J Force a printer to 

1 

1 





CLFUNCSM 

00660 

1 single space output. 

| SPACE 

1 



CP 


CLFUNCSM 

00661 


1 

j 





CLFUNCSM 

00662 

1 start spooling device after 

I 

1 





CLFUNCSM 

00663 

| draining or changing output 

1 

1 





CLFUNCSM 

00664 

j class. 

| STAFT 

1 



CP 


CLFUNCSM 

00665 


J 






CLFUNCSM 

00666 

j Direct spooled files to a 

1 

j 





CLFUNCSM 

00667 

j user's card reader. 

J TRANSFER 

8 



CP 


CLFUNCSM 

00668 

j_ 

___ - 


_ r , - - 


_ T - 

.J 


CLFUNCSM 00670 Figure 13* CoeBands for Spooling Control (Part l of 2) 
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CLFONCSH 
CLFONCSN 
CLFONCSN 
CLP0NC5N 
CLFONCSN 
CLFONCSH 
CLFUNCSN 
CLFONCSN 
CLFUNCSN 
CLFONCSf! 
CLFONCSH 
CLFUNCSH 
CLFONCSN 
CLFONCSN 
CLFONCSN 
CLFONCSN 
CLFONCSN 
CLFONCSH 
CLFONCSN 
CLFONCSH 
CLFONCSN 
CLFONCSN 
CLFONCSN 
CLFONCSH 
CLFONCSN 
CLFONCSN 
CLFONCSH 
CLFONCSH 
CLFONCSH 
CLFONCSN 
CLFONCSN 

CLFONCSN 


00674 


.... 


——'—-—--—-j 

00675 


1 

1 


00676 

| FUNCTION 

| COHHANO 

1 

SUB- IliPE I 

00677 


1 

1 

COHNANC, | | 

00678 

00679 

,- 

8 

-1- 

1 

OP1ICN | | 

-1-1 


00680 




1 

i 1 


00681 


1 

Display real storage 

1 

1 1 


00682 


1 

at terainal. 

| DCP 

1 1 CP 


00683 


1 


1 

1 t 


00684 


1 

Duap real storage to 

1 

1 1 


00685 


1 

virtual spooled printer. 

| DHCP 

1 1 CP 


00686 


i 


1 

1 1 


00687 


1 

Find locations of % 

1 

1 ! 


00688 


1 

control blocks. 

| LOCATE 

1 i CP 


00689 


! 

■ 

1 

1 1 


00690 


1 

Save virtual aachine t 


1 1 


00691 


1 

storage space on disk. 

| SAVEEYS 

} I CP 


00692 


1 


1 



00693 


1 

Perfora intensive 

1 

1 1 


00694 


1 

recording of device 

1 

1 1 


00695 


1 

activity inforaation. 

| SET 

I BECCfD 1 CP 


00696 


1 

’ ' 

1 



n 0697 


1 

Duap error inforaation which 1 

1 I 


00698 


1 

has been recorded by error 

1 

1 1 


00699 


J 

recording routines. 

| CPEREP+ 

1 1 CP 


no700 







00704 


1 

* Hefer to IM Ijtfcial flaskias lasiliiii' 



00705 

■ t 

8 

Guide (Order No. GC20-1806) for a discussion of this 


00706 


1 

coaaand. 




00707 




— -_. __ 

_1_,- „ 



00709 Figure 14. Coaaands for Systba and Hardware Analysis 
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CLCMSINT 


CLCHSINT 


CLCMSINT 
CLCHSINT 
CLCMSINT 

CLCHSINT 
CLCHSINT 
CLCMSINT 
CLCMSINT 
CLCHSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 
CLCHSINT 
CLCMSINT 
CLCMSINT 
CLCMSINT 

CLCMSINT 


00005 


£fl£ CQflflAUfiS 


00008 




00010 

00012 

00014 

00024 

00025 

00026 

00027 

C0028 

00029 

00030 

00031 

00032 

00033 

00034 

00035 

"0936 

00037 

00038 

00039 

00040 

00041 

00042 

00043 

00044 

00045 

00046 

00047 

00048 

00049 

00050 

00051 

00052 

00053 

00054 

00055 

00056 

00057 

00058 

00063 

00064 

00065 

00066 


This section contains descriptions of the coaaands acceptable 
CMS environment. Figure 6 contains an alphabetical list < 
coaaands and functions perforaed by each of the commands. 


COMMAND 


ACCESS 

ASSEMBLE 

BASIC 

•COBOL 

COMPABE 

♦CONTEST 

COPYFILE 

CP 

♦ •CPEHEP 

DDB 

DEBOG 


USAGE 


I 


define direct access space tc a CMS virtual 
machine, and relate the disk, space to a 
logical directory. 

asseable Asseabler language source code 

coapile and execute VM/37C EAS1C prograas 

conpile ANS Version 4 COBOL source code 

coapare all or part of records in two existing 
files 

convert free fora FOBTBAN statements tc 
fixed fora 

copy files according to specifications 

enter CP coaaands froa CMS environaent 

dump error information which has been 'recorded 
by VH/370 error recording routine 

perfora backup, restore, and copy operations 
on ainidisks 

enter DEBUG subenvircnaent 


• These coaaands are used to invoke processors which are 
IBM Prograa Products. They are available through IBM 
for a license fee. 

** Befer to Ifijl Victual Machine Facili ty/3 7Q Oxexatcj^ 
G uide (Order No. GC20-1806) for a discussion of this 
coaaand. 


00068 


Figure 15. CMS Coaaand Sunnary (Part 1 of 4) 
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CLCHSINT 0007t 
CLCHSINT 00072 
CLCHSINT 00073 
CLCHSINT 00074 
CLCHSINT 00075 
CLCHSINT 00076 
CLCHSINT 00077 
CLCHSINT 00078 
CLCHSINT 00079 
CLCHSINT 00080 
CLCHSINT 00081 
CLCHSINT 00082 
CLCHSINT 00083 
CLCHSINT 00084 
CLCHSINT 00085 
CLCHSINT 00086 
CLCHSINT 00087 
CLCHSINT 00088 
CLCHSINT 00089 
CLCHSINT 00090 
CLCHSINT 00091 
CLCHSINT 00092 
CLCHSINT 00093 
CLCHSINT 00094 
CLCHSINT ^0095 
CLCHSINT 00096 
CLCHSINT 00097 
CLCHSINT 00099 
CLCHSINT 00099 
CLCHSINT 00100 
CLCHSINT 00101 
CLCHSINT 00102 
CLCHSINT 00103 
CLCHSINT 00104 
CLCHSINT 00105 
CLCHSINT *0106 
CLCHSINT 00107 
CLCHSINT 00108 
CLCHSINT 00109 
CLCHSINT 00110 
CLCHSINT 00111 
CLCHSINT 00112 
CLCHSINT 00113 
CLCHSINT 00114 
CLCHSINT 00115 
CLCHSINT 00120 
CLCHSINT 00121 
CLCHSINT 00122 
CLCHSINT 00123 

CLCHSINT 00128 Figure 15. CHS Command Summary (fact 2 of 4) 
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COHHAND 


FILEDEP 


FOBHAT 


♦FOflTHX 


GLOBAL 


♦GOFORT 


LISTFILE 


set up User Directocy entries 

perfora disk—to-eatd and card-to disk 
operations for CHS data sets 

enter EDIT subenvircnnent 

delete files froa user disks 

process special procedures aade up of 
frequently-used sequences cf commands 

provide siaulation cf CS JCL data definition 
(DD) statement^? 

prepare disks in CHS 800-fcyte block fcraat 

coapile FORTRAN source cede using G1 compiler 

coapile FORTRAN source cede using H-extended 
coapiler 

create auxiliary aoduie directories 

generate absolute ncn-relocatafcle file 
(HODULE files) 

define CHS libraries to be searched for aacros 
and subroutines 

coapile FORTRAN source code and execute 
program just compiled using Code and Gc 
compiler 

bring additional TE>T files into storage 
list information about iser CHS files 


* These commands are used to inveke processors fchich are 
IBfl Program Products. They 0 are available through IfcH 
for a license fee. 

** Refer to Ifijj liliuai fiac^ins lasilitlZiifi 2 £££dt££:j 2 
g uide (Order No. GC20-1996) fee a discussion of this 
command. 
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CLCHSINT 

CLCHSINT 

fLCHSINT 

clchsint 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 

CLCHSINT 


'■*0130 

00131 


COH HAND 

| USAGE 

v / 1 J C 

00133 

I 

LOAD 

(bring TEXT files into storage and establish 

00134 



jlinkages 

00135 



1 

00136 


LOADHOD 

(bring a single HODU1E file into storage 

00137 



! 

00138 


HACLIB 

(per fora maintenance cc macro libraries 

00139 



1 

00140 


**HINIDASD Jforaat disk relumes in DOS cc OS format 

00141 

J 


i 

00142 


HODHAP 

|type load nap of a HCDULE file 

00143 



1 

00144 


H07 EFILE |move data froa one device to another device 

00145 



(of the sane or different type 

00146 



I 

00147 


*PLIOPT 

(compile PL/1 source code (using cptiaizing 

00148 



(compiler) 

00149 



1 

00150 


PRINT 

(spool a specified file tc the printer 

00151 



1 

00152 


PUNCH 

(spool a specified file tc the funch 

00153 



1 

00154 


QUEHY 

(request inforaation about the virtual aachine 

00155 



1 

00156 


READCARD (read data troa spccled card incut device 

00157 



1 

0 0158 


RELEASE 

|aake a disk and its directory inaccessible 

00159 



(to a virtual aachine 

00160 



1 

00161 


RBNAHB 

(change the naae of a CHS file or tiles 

00162 



1 

00163 


RUN 

(initiate series of funciicrs tc te perfected 

00164 



(on a file 

00165 



1 

00166 


SET 

(establish, set, or reset virtual aachine 

00167 



|characteristics 

00168 




00169 


* These 

coaaands are used to invoke processors vhich are 

00170 


£BH Prograa Products. They are available through ltd 

00171 


for a 

license fee. 

00172 




00177 


** Refer 

to Ififl Visual OacfeiBS facililXZ37g fiiejcatcj^s 

00178 


Guide 

(Order No. GC20-1806) tor a discussion of this 

0 0179 

00180 

L_ 

coaaand. 

00182 

Figure 15. 

CHS Coaaand Suaaary (Part 3 cf 4) 
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CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 


CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 

CLCMSINT 


00185 
00186 
00187 
00188 
00189 
00190 
00191 
00192 
00193 
00194 
00195 
00196 
00197 
00198 
00199 
00200 
00201 
00202 
0 0 203 
00204 
00205 
00206 
00207 
00208 
00209 
00210 
00211 
00212 
00213 
00214 
00215 
00220 
00221 
00222 
00223 

00225 Figure 15. CHS Coaaand Summary (Part 4 of 4) 


00231 Any of the coaaands in Figures 24*26 nay be entered when the 
00232 user is running CMS in his virtual nachine and the terninal 
00233 is idle and the keyboard is unlocked.. If the keyboard is 
00234 locked (a coaaand is executing) the user nay press the ATTN 
*9234 key (or its equivalent) and when the Attention interrupt 
0*235 occurs, enter the coaaand. It will not be eaecuted until the 
00237 coaaand that is currently executing coapletes. 

00238 In additions to the coaaands listed in Figures 24*26, there 
00239 are four coaaands called Iaaediate Coaaands which are handled 
00240 in a different aannec froa the others. They nay be entered 
00241 while another coaaand is executing by pressing the AI1N key 
00242 (or its equivalent) and will be executed iaaediately. The 
*0243 Iaaediate Coaaands are: 


COMMAND ( USAGE 


SORT 

START 

STATE 

SVCTRACB 

SYNONYM 

TAPE 

TAPPDS 

TXTLIB 
TYPE 
UPDATE . 

**VD0HP 


arrange a specified file in ascending crder 
according to specified fields in the data 
record 

begin execution of prograas previously leaded 

verify the existence of a file 

record inforaation about supervisor calls 

specify alternate naaes by which certain 
coaaands aay be invoked 

perforas tape-to-disk £nd disk-to-tape 
operations for CMS data sets 

load OS partitioned data set (PCS) files froa 
tape to disk 

perfora aaintenance on text libraries 

type all or part of a file at the terninal 

aake changes in a file as defined by control 
cards in a second file 

convert systea ABEND duaps to printed output 


** Refer to IBM Virtual Machin e Facilitv/ 370 Ope ratc r*s 
Guide (Order No. GC20—1806) for a discussion of this 
coaaand. 
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CLCMSINT 

00247 

• 

HO - Halt 

tracing 

CLCHSINT 

00249 

• 

HT - Halt 

typing 

CLCMSINT 

00251 

• 

HY - Halt 

execution 

CLCHSINT 

00253 

• 

RT - Besuae typing 


CLCHSBHH 00007 


egg E rror Massages and Besponses 


CLCMSEBR 00009 
CLCMSERR 00009 
CLCHSERR 000tO 
CLCMSERR 00011 
CLCHSERR 00012 


The responses froi each CHS coanand are shown relieving the 
coaaand discussion* Although it is not stated in the 
response section, the READ! aessage is received after each 
coaaand has finished execution. The foraat of the READY 
aessage is: 


CLCMSERR 00014 R; T*x.xx/y.yy hh:aa:ss 


CLCHSERR 00018 where 
CLCMSERR 00019 
CLCMSERR 00021 
CLCMSERR 00022 


x. xx is the virtual CPU tine used since the last 

READY aessage was issued. 

y. yy is the total CPD tiae used since the last 

READY aessage was issued. 


CLCMSERR 00024 and 
CLCMSERR 00025 


hh:aa:ss is the current, real 
hours:ainutes:seconds. 


clock tiae in 


CLCHSERR 00028 The user nay cause the RBADY aessage to be printed as R; by 
CLCMSERR 00029 issuing the coaaand: 

CLCMSERR 00037 ,-■, 

CLCMSERR 00038 | SET RDYBSG SMSG | 

CLCMSERR 00039 «-J 


CLCHSERR 00047 Refer to £811 Virtua l Mach in e Facil itv/3 70. §l 5 ief Me ssag es 
CLCHSERR 00048 (Order Ho. GC20-1808) for a description of the aessages 
CLCHSERR 00049 produced by the CHS coaaands. All aessages fron CES coanands 
CLACCESS 00001 have the prefix DHS. 
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CLACCBSS 00012 


CLACCESS 00014 
CLACCBSS 00015 
CLACCBSS 00016 


The ACCESS coaaand acquires disk space for the user and sets 
up user file directories in lain storage to he used during a 
terainal session. 


CLACCBSS 00019 
CLACCBSS 00020 
CLACCBSS 00021 
CLACCBSS 00022 


| ACCESS | 
I I 


([ecu aode[ /ext [ fn [ft [ f ■ 33333 C (NOEROF | ERASE) ] } | 
[ (NODISK) j| 


CLACCESS 00027 CCU 
CLACCBSS 00029 
CLACCBSS 00030 
CLACCESS 00031 
CLACCESS 00032 


specifies the device address of the disk tc be 
■ade available to the terminal user. This field 
ausi be specified if paraaeters ether than the 
default values are desired unless the NODISK 
option is selected. The default value is 191. 


CLACCBSS 00034 node 
CLACCESS 00035 
CLACCESS 00035 
CLACCESS 00036 
CLACCESS 00037 


specifies the 1 character node letter which is to 
be associated with the disk being accessed. This 
field aust be specified if ecu is specified unless 
the NODISK option is selected. The default value 
is A. 


CLACCBSS 00039 ext 
CLACCBSS OO040 
CLACCBSS 00041 
CLACCESS 00042 


indicates the node of the parent disk fez which 
the file directory of this disk is to be a 
read/only extension. There aust ret be a blank 
preceding or following the slash (/). 


CLACCBSS 00044 fn 
CLACCESS 00045 
CLACCESS O0046 
CLACCESS 00046 
CLACCESS 00048 


specifies the filenaae of the files to te selected 
for inclusion in the file directcry cf the disk 
being accessed. An asterisk coded in this field 
aeans that all filenaaes are to te used in file 
selection. See note 6. 


CLACCBSS 00050 ft 
CLACCESS 00051 
CLACCESS 00051 
CLACCESS 00053 
CLACCESS 00054 


specifies the filetype of the files to be selected 
for inclusion in the file directcry cf the disk 
being accessed. If an asterisk is ceded in this 
field, all filetypes are used in file selection. 
See note 6. 


CLACCESS 00056 fa 
CLACCESS 00057 
CLACCESS 00057 
CLACCESS 00058 
CLACCESS 00058 
CLACCESS 00060 


specifies the filenode of the files to te selected 
for inclusion in the file directcry cf the disk 
being accessed. An asterisk codec in ttie field 
aeans that all files on the disk specified by the 
node letter and device address are selected, 
regardless of node nuaber. See note 6. 


CLACCESS C0063 
CLACCBSS 00064 
CLACCESS 00065 


Note: An asterisk (*), preceded by any nuaber cf characters 
for filenaae or filetype allows the specified characters to 
be used as the leading characters for that identifier. For 
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CLACCESS 00065 example, ABC* for fn allows access to all files with 

CLACCESS 00067 filenames beginning with ABC. 


CLACCBSS 00070 Opti ons 


CLACCESS 00072 NOPROF 
CLACCESS 00073 
CLACCESS 00073 
CLACCESS 00073 
CLACCESS 00074 
CLACCESS 00075 

CLACCESS 00077 ERASE 

CLACCESS 00C78 
CLACCESS 00078 
CLACCESS 00079 
CLACCESS 00C79 
CLACCESS 00080 
CLACCESS 0O081 
CLACCESS C0082 

CLACCESS 00084 NODISK 

CLACCESS 00085 
CLACCESS 00085 
CLACCESS 00086 
CLACCESS *>9088 


CLACCESS 00091 Note s 


CLACCESS 00095 1. The PROPILE EXEC file is an EXEC procedure which nay 

CLACCESS 00095 perform initialization and set system parameters 

CLACCESS 00096 required by the user's processing. For example, if the 

CLACCESS 00097 user is asseabling or compiling programs which use 

CLACCESS 00098 macros, the PROFILE EXEC procedure can issue-the GLOBAL 

CLACCESS 09099 command to indicate where the system should search for 

CLACCESS 00099 the macros; if he is running OS programs, the PROFILE 

CLACCESS 00100 EXEC procedure can set up ’ FILEDEF statements for the 

CLACCESS 00101 files he will be using. 

2* If an ACCESS command is not entered as the first 
command after an IPL CMS command has been performed, 
the following command: 

CLACCESS 00107 ACCESS 191 A 

CLACCESS 00110 is automatically performed and the usei's LRCFILE EX EC 

CLACCESS 00111 file, if one exists, is executed. 


CLACCESS 00103 
CLACCESS 00104 
CLACCBSS 00105 


specifies that the user's PROFILE EXEC file 
(see Note 1.) is not to be executed. This 
option is valid only if the command is the 
first one entered after an IFL of the CHS 
system. On subsequent ACCESS commands, this 
option is ignored. 

specifies that the file directory created tor 
the dislc being accessed is tc ccntain no 
entries, and 0 the space previously used ty 
files on that dish is to be available for new 
files. This option is valid only for disns 
in read/write mode. This does net alter the 
file directory on the disk but cnly the 
directory in main storage (see Ncte 4). 

specifies that the user is tc gain access to 
the CMS system without a user disk. This 
option is valid only in the first command 
after an IPL. If it is specified, no other 
parameters or options may be iscd. 
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CLACCESS 00114 
CLACCESS 00115 
CLACCESS 00116 
CLACCESS 00117 


3* The dish being accessed aust have previously been 
foraatted using the CMS coaaand FOBMA 1 . In crder tc 
foraat an unforaatted dish, the usee acst first issue 
ACCESS (NODISK) then FORMAT ecu node after IELing. 


CLACCESS 00119 
CLACCESS 00120 
CLACCESS 00121 
CLACCESS 00121 
CLACCESS 00122 
CLACCESS 00123 
CLACCESS 00123 
CLACCESS 00124 
CLACCESS 00124 
CLACCESS 00125 
CLACCESS 00126 
CLACCESS 00126 
CLACCESS 00127 


4, If an ACCESS coaaand with the ERASE option i£ entered 
by aistaka, the user aay regain access tc the existing 
files on the disk either by issuing another ACCESS 
coaaand without the ERASE option, or by issuing a 
RELEASE coaaand for the disk. This is possible since 
the ERASE option does not alter the disk directory cr 
disk files, but specifies that the directory built in 
aain storage is to contain no entries. However, if a 
CMS coaaand is executed which causes a new file to be 
written on the disk, the disk directory is updated and 
the files which were on the disk before the execution 
of the ACCESS coaaand with ERASE option are no longer 
available. 


CLACCESS 00130 
CLACCESS 00130 
CLACCESS 00131 
CLACCESS 00133 


5. If the initial ACCESS coaaand (either explicit cr 
iaplied) encounters an error, a aessage is typed at the 
terainal and the keyboard unlocks to accept another 
coaaand; no disk has been accessed. 


CLACCESS 00136 
CLACCESS 00136 
CLACCESS 01137 
CLACCESS 00138 
CLACCESS 00140 


6 . If a fileid is specified for a read/write disk that is 
accessed read/write, all files on the disk will be Bade 
available. A fileid can only be specified with disks 
which are accessed as read/only extonsiens. Files with 
a aode nuaber of 0 will not be accessed. 


CLACCESS 00144 


Exaaple 1 


CLACCESS 09151 ,-■, 

CLACCESS 00152 | ACCESS 192 B | 
CLACCESS "0153 | | 
CLACCESS 01154 • -J 


CLACCESS 00158 Acti on: this coaaand aakes available to the user for 

CLACCESS 09159 reading, all files on 192 (which is to becoxe the user's E 

CLACCESS 99160 disk) . 


CLACCESS 03162 Exaaple 2 


CLACCESS 00164 ,-, 

CLACCESS 00165 | AC 192 B/B ABC j 
CLACCESS 01166 ( | 
CLACCESS "9167 »-- j 
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CLACCESS 00171 Acti on: this coeaand provides read/only access to all files 

CLACCESS 00173 on the B disk with a filename of ABC. 


CLACCESS 00176 Exanple 3 


CLACCESS 00178 ,-, 

CLACCESS 00179 ( ACC 192 B/B ABC* | 
CLACCESS f>0180 | J 
CLACCESS 00181 «--■» 


CLACCESS 00185 
CLACCESS 00186 
CLACCESS 00187 


Ac j^ on: this coeaand provides read/only access to the user 
to all files on the B disk whose filenaaes have AEC as the 
first three characters. 


CLACCESS 00190 


Exanpie 4 


CLACCESS 00193 
CLACCESS 00194 
CLACCESS 00195 
CLACCESS 00196 


| ACCE 192 

f 

■ 


B/B ABC * B2 j 
I 


CLACCESS 00200 Acti on: the user has read/only access to all files cn the £ 

CLACCESS 00202 disk that have a filenaae of ABC and are in read/cnly node. 


CLACCESS 00204 Exaaple 5 


CLACCESS 00206 ,--- 

CLACCESS 00207 | ACCES 191 A/A | 
CLACCESS 00208 | f 
CLACCESS 00209 «---J 


CLACCESS 00213 AsjkiSJJJ the A disk is placed in read/only node, 


CLACCESS 00216 Exaaple 6 


CLACCESS 00218 ,-- 

CLACCESS O0219 | ACCESS 194 D/A j 
CLACCESS 00220 | j 
CLACCESS 00221 > ---J 


CLACCESS 00224 Acti on: the D di.sk is Bade a read/only extension Of the A 

CLACCESS 00226 di3k. This changes the standard disk search order to 
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CLACCESS 

00228 

A# D, By C| E f Pi (ay Sy ¥y Z 

CLACCBSS 

CLACCESS 

0 0231 
00232 

The A disk aust have been accessed before this command is 
issued* 

CLACCESS 

CLACCESS 

00233 

00235 

The effect of this coaaand aay be negated fcy entering the 
following coaaand. 

CLACCESS 

CLACCESS 

CLACCESS 

CLACCESS 

00238 

00239 

00240 

00241 

i— -1 

| ACCESS 194 D | 

1 i 

‘ -- ... * 

CLACCESS 

00244 

Exaaple 7 

CLACCESS 

CLACCESS 

CLACCESS 

CLACCESS 

00246 

00247 

00248 

00249 

tr ..—.— ---1 

| ACC (NOPROF) ) 

1 1 
i_ _j 

CLACCESS 

CLACCESS 

CLACCESS 

00252 

"9253 

00255 

Action; if this coaaand is the first one entered after 
loading CHS, disk 191 is accessed as the user's A disk, and 
the user's PROFILE EXEC file is not executed. 

CLACCESS 

"0257 

Exaaple 8 

CLACCESS 

CLACCESS 

CLACCESS 

CLACCESS 

"0259 

00260 

00261 

00262 

i .... -—— i 

1 AC 191 A (ERASE) | 

1 1 
«- _j 

CLACCBSS 

CLACCESS 

CLACCESS 

00266 

00267 

00269 

disk 191 is aade available to the usee as his A 
disk, but the file directory built contains rc entries. All 
space on the disk is now available for new tiles. 

CLACCBSS 

00273 

Responses 

CLACCESS 

00276 

DNSACC723I »aode (ecu)' R/G 

CLACCESS 

ZLACCESS 

0 0278 
00279 

The specified disk is attached to the CHS victual machine in 
read/only node. 

CLACCESS 

00281 

DNSACC724I 'cuul' REPLACES 'node (cuu2)• 
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CLACCESS 

CLACCESS 

CLACCESS 


CLACCESS 

CLACCESS 

CLACCESS 

CLACCESS 


CLACCESS 

CLACCESS 

CLACCESS 

CLACCESS 

CLACCESS 

CLASSEN!) 


00283 Before execution of the coaaand the disk represented by ccu2 
00283 was the user's 'node' disk, ecu 1 is now asrigned that nede 
00285 letter. This nessage will be followed by nessage DUEACC7261 . 


00287 DNSACC725I 'ecu' ALSO * ‘Bode* DISK 

°0289 The disk specified by ecu is the user's 'mode' disk and he 
00289 has issued an ACCESS conaand to assign it another aode 
C0290 letter. 


00294 DHSACC726I 'ecu BOde [/ext]' RELEASED 

00295 The disk located at virtual address ecu that is being 
00296 accessed as a read/write disk is already currently accessed. 
00297 The effect of the previous ACCESS conaand is cancelled and 
00298 the disk is released froa the user's virtual aachine 
00001 configuration. 
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CLASSEMB 00004 ASSEMBLE 


CLASSEHB 00005 The ASSEMBLE coaaand invokes the VN/370 Systea Assembler tc 
CLASSEMB 00006 assemble the specified file. Asseabler processing and 
CLASSEMB 00008 output are controlled by the options selected. 


CLASSEMB H0019 
CLASSEMB 00020 
CLASSEMB 00021 

CLASSEMB 00022 
CLASSEHB 00023 
CLASSEMB 00024 
CLASSEHB 00025 
CLASSEHB 00026 
CLASSEHB 00027 
CLASSEHB 00028 
CLASSEHB 00029 
CLASSEHB 00030 
CLASSEHB 00031 
CLASSEHB 00032 
CLASSEHB 00033 
CLASSEHB 00034 
CLASSEHB 00035 


CLASSEHB 

CLASSEHB 

CLASSEHB 

00041 

00043 

00045 

fn 

specifies the filename of the source file to be 
assembled. The file oust have a filetype cf 
ASSEMBLE and fixed-length, 80-character records. 

CLASSEHB 

00048 

Options 


CLASSEMB 

CLASSEMB 

00050 

00051 

If duplicate or conflicting options are specified, the last 
one entered in the coaaand line will be in effect. 

CLASSEHB 

CLASSEHB 

00053 

00055 

1*2Z 

includes a cross-reference synbcl table in the 
LISTING file. 

CLASSEHB 

00058 

NOXHEF 

suppresses the cross-reference syabol table. 

CLASS EH3 
CLASSEHB 

^0060 

00062 

BENT 

a check for satisfaction of reentrancy 

requirements is aade of the source tile. 

CLASSEHB 

CLASSEMB 

00064 

00065 


suppresses the check for satisfaction of 

reentrancy requirements. 

CLASSEHB 

CLASSEHB 

00067 

00068 

DECK 

the output object module, fn TEXT, is spooled to 
the punch. 

CLASSEHB 

CLASSEHB 

00070 

O0071 

NOfiESlS 

the output object aodule, fn TEXT, is not spooled 
to the punch. 

CLASSEHB 

CLASSEHB 

00073 

00075 


a TEXT file is created on disk for the program 
that was asseabled. 
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ASSEMBLE ( fn 

[(option. 

..) 3 


A 1 

options: 

[ XREF|NOXREF ] 


S 


£ RENTJ NOFENT ] 




£ DECK|NO DECK] 




£L0AD1NOLOAD] 


1 


£ A|jGN|NOALGN ] 


1 


£OS| DOS ] 


1 


£ TEST|NO£EST] 


1 


£ LINEC NT (nnjJSjJji) ] 


1 


[PRINTJ^ISKINOtBINT] 


1 


£ TERM| NOTEBM ] 




£ NUM|NONUN ] 


1 


£ STMT |NfiSIUI] 


] 


CilST|NOLIST] 
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CLASSEMB 

CLASSEMB 

00077 

00079 

NOLOAD 

CLASSENB 

CLASSEMB 

00082 

00083 

ALGN 

CLASSEMB 

00087 

NOALGN 

CLASSEMB 

00090 

LI SI 

CLASSEMB 

00093 

NOLIST 

CLASSEMB 

CLASSEMB 

00095 

00096 

25 

CLASSEMB 

CLASSEMB 

CLASSEMB 

CLASSEMB 

CLASSEMB 

CLASSEMB 

CLASSEM3 

00098 

00100 

00101 

00102 

00104 

00105 

00107 

DOS 

CLASSEMB 

00110 

TEST 

CLASSEMB 

00113 

NOTES! 

CLASSEMB 

00116 

PRINT 

CLASSEMB 

00119 

HIM 

CLASSEMB 

00122 

NOPBINT 

CLASSEMB 

CLASSEMB 

CLASSEMB 

00124 

00126 

00127 

STMT 

CLASSEMB 

CLASSEMB 

00129 

00130 

SQS2S1 

CLASSEMB 

CLASSEMB 

CLASSEMB 

CLASSEMB 

00132 

00133 

00135 

00136 

MS 

CLASSEMB 

00139 

NO NON 

CLASSEMB 

CLASSEMB 

00142 

00143 

TERM 

CLASSEMB 

00146 

NOTEBM 


a TEXT file is not created on disk for the prcgtaa 
that was assembled. 

does not suppress alignaenf error diagnostic 
aessages. 

suppresses alignaent error diagnostic aessages. 
produces a LISTING file, 
produces no LISTING file. 

the dsseabler will produce OS coapatible object 
prograas. 

the Asseabler will behave like DCS Asseablers E 
and F and produce DOS coapatible object prcgraas. 
If the DOS option is specified, the LCAC, TEST, 
and NO&LGN options aust not be specified; they are 
not coapatible with the DOS option. 

No DOS aacro libraries are provided with VS/370. 
DOS object prograas will not execute under CHS. 

generates a syabol fable as part of the TEXT tile. 

undoes not generate a syabol table. 

ni.i . 

spools the LISTING file to the printer, 
puts the LISTING file on disk, 
produces no LISTING file. 

the internal stateaent nuabers are tc appear with 
the diagnostic aessages sent to the terainal. This 
option is aeaningful only when used with 1EBM. 

the internal stateaent nuabers are net tc be 
included. 

the sequence nuabers assigned to each source 
stateaent in the input file are fc be typed in 
diagnostic aessages to the terainal. lhis option 
is aeaningful only when used with TERM. 

the sequence nuabers are not included. 

specifies that diagnostic aessages are to be typed 
at the terainal, 

no diagnostic aessages are to be typed. 
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CLASSENS 00149 
CLASSRHB 00151 
CLASSENB 00153 


LIMECMT nnlSSL 

specifies the nuaber of lines pec output printer 
page. A default of 55 lines is assumed. 


CLASSENB 00157 


files Create d, tjje ASSfiflfiif £2ilfiad 


CLASSENB 00159 


Teaporacy Horkfiies: 


CLASSENB 00162 
CLASSENB 00164 
CLASSENB 00166 


fn SYSOT1 
fn SYS0T2 
fn SYS0T3 


CLASSENB 00168 
CLASSENB 00169 
CLASSENB 00170 
CLASSENB 00171 
CLASSENB 00172 
CLASSENB 00173 
CLASSENB 00175 
CLASSENB 00176 


These files are teaporarily created for each assembly; any 
existing files vith the saae file identifiers are erased at 
the beginning of the asseably. These files are placed on 
the read/write disk with the aost available space. Wcrk 
space is autoaatically allocated as needed during the 
asseably and returned to available status when the asseably 
is complete. Insufficient space causes abnoraal teraination 
of the asseably. 


CLASSENB 00178 


files: 


CLASSENB 00181 
CLASSENB 00183 


fn TEAT 
fn LISTING 


CLASSENB 00186 
CLASSENB 00186 
CLASSENB 00187 
CLASSENB 00188 
CLASSENB 00189 
CLASSENB "0190 
CLASSENB 00191 
CLASSENB 00192 
CLASSENB 00192 
CLASSENB 00193 
CLASSENB 00195 


fn TEXT contains the output object nodule if the LOAD opticn 
is in effect. fn LISTING contains a listing of source 
stateaents, assembled aachine code, and ether associated 
infornation based on the options selected.' This file is 
created unless the NOPBINT or NOLIST options are selected. 
The LISTING and TEXT files are placed on (1) the disn iron 
which the source file was read, (2) its parent disk, or (3) 
the prinary disk, unless the user has created a file 
definition for these files placing then on a non-DASD 
device. Failure to obtain sufficient space for these files 
results in abnoraal teraination of the asseatly. 


CLASSENB 00197 


References 


CLASSENB 00199 
CLASSENB 00199 
CLASSENB 00201 
CLBASIC 00001 


For a description of facilities available to users cf VN/370 
Assembler Language, see the following publication: 

liElaal flashing EafiUiiiZJXQ* Ass eabi gr EissisjisiIs finiis 

(Order No. GC20-1802). 
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CLBASIC 

0000* 

.BASIC 



CLBASIC 

CLBASIC 

00008 

00010 

The BASIC 
Processor to 

coaaand 

compile 

invokes the VM/370 EAS2C Language 

and execute the specified pregraa. 


CL BA SIC 00023 
CLBASIC 00025 
CLBASIC 00026 
CL BASIC 00027 

CLBASIC 00036 fn specifies the filename of the file to be compiled and 
CLBASIC 00037 executed. The file aust have a filetjpe of £AS1C and 
CLBASIC 00038 contain fixed length 80-charactec records. 

CLBASIC 00040 LONG is the option for long fore precision# If not 
CLBASIC 00042 specified, short fore is assuied. 


CLBASIC 000*6 References 


CLBASIC C0047 For a description of the BASIC language see the IBM 

CLBASIC 00050 publication IBM Virtual Machin e Fa c ili ty/370. SIC Lang uage 

CLBASIC 000511 Refe r ence Manual (Order No. GC20-1803) . 


CLBASIC 00055 Files Osed fry VH/370 BASIC Progr aas Duri ng Execution 

CLBASIC 00057 Input and output files used during the execution cf VB/370 
CLBASIC 00057 BASIC progress aust have a filetype of *BISCATA*, uith a 
CLBASIC 00058 filename as designated by the OPEN stateaent in the prograa. 
CLBASIC 00059 The record format is the standard BASIC data record format 
CLBASIC 00060 (that is, undefined record, with a aaxiaua record length of 
CLBASIC 00061 3440 characters). 


CLBASIC 00063 Resp o nses 


CLBASIC 00065 For responses froa the BASIC processor, refer tc the aanual 

CLCOMPAR 00001 already noted under "References". 
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CLCOMPAR 


CLCOMPAR 

CLCO.IPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 

CLCOUPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 


CLCOMPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 


00003 COMPA RE 


00014 The COMPARE command is used to compare two dish files cr 
00015 fixed or variable length format and type the contents c£ 
00017 corresponding unlike records at the terainal. 


00019 ,- t 

00020 | COMPARE | fileidl fileid2 £ (COL am-nn) ] 9 

00021 J COM J i 

00022 «- J 

00027 fileid specifies the file identification cf the two 

00028 files to be compared. All three components 

00029 (filename, filetype, and fileaode) oust be 

00030 specified for each fileid. 


00033 Options 


00035 

00037 

00038 

00039 

00040 

00040 

00041 

00042 

00042 

00043 

00044 


COL aa-nn By using this option, the user can define any 
contiguous portion of the corresponding records 
for comparison. The comparison begins at 

position aa of each record in loth files. The 
comparison proceeds up to and includicg position 
nn of each record in both files. If nn is not 
specified the default ending position is the 
last character of each record. The is 

required and it may not be preceded cr followed 
by a blank. LRECL is the logical record length 
of the file. 


90047 Example 1 


00049 ,- 

00050 J COMPARE J ABC XIZ A1 ABC NNO A1 | 
00051 «- --J 


00055 

00056 

00057 

00058 

00059 


i£t£.oi|: each record in file ABC XYZ A1 is ccnpared with the 
corresponding record in file ABC MNO Al. comparison begins 
at the first position of each record and proceeds for the 
entire length of the record* Records which do net match are 
typed on the terainal typewriter. 
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CLCOMPAB 

C LCOHPAH 
CLCOMPAR 
CLCOMPAB 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 

CLCOMPAR 


CLCOMPAR 

CLCOMPAB 

CLCOMPAR 

CLCOPYF 


00062 Example 2 

0 0064 ,---t 

00065 j COMPARE JMTFILE ASSEMBLE A1 YOURFILE ASSEMELE A1 (COL 10-72)| 

00066 *-------—-—* 

00069 Acti on: positions 10-72 of each record in file HYFILE 

^0070 ASSEMBLE A1 are compared with corresponding positions of 

00071 each record in file YOUBFILB ASSEMBLE Alt Reccids in which 

00072 these positions do not natch are typed cn the terminal 

00073 typewriter. 


00075 Resp o nses 

00077 If corresponding records in each file do not aatcb, the 
00078 record fron the first file is typed, followed by the record 
00001 froa the second file. 
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CLCOPYP 

00004 

CLCOPYF 

00006 

CLCOPYF 

00007 

CLCOPYF 

00009 

CLCOPYF 

00009 

CLCOPYF 

00010 

CLCOPYF 

^0012 

CLCOPYF 

00014 

CLCOPYF 

00019 

CLCOPYF 

00021 

CLCOPYF 

00023 

CLCOPYF 

00025 

CLCOPYF 

00027 

CLCOPYF 

"0930 

CLCOPYF 

00031 

CLCOPYF 

00032 

CLCOPYP 

00033 

CLCOPYF 

00034 

CLCOPYF 

00036 

CLCOPYF 

00037 

CLCOPYF 

00041 

CLCOPYP 

00043 

CLCOPYF 

00045 

CLCOPYP 

00046 

CLCOPYF 

00048 

CLCOPYF 

00049 

CLCOPYF 

00051 

CLCOPYF 

00052 

CLCOPYF 

00054 

CLCOPYF 

00056 

CLCOPYF 

00057 

CLCOPYF 

00059 

CLCOPYF 

00061 

CLCOPYF 

00062 

CLCOPYF 

00064 

CLCOPYF 

00065 

CLCOPYF 

00066 

CLCOPYP 

0C068 


£0£X£U>£ 


The COPYFILE command copies data from specified infut files 
to the output files according to conversions and 
specifications indicated by the options selected. The Banner 
in which the file identifiers are entered determines whether 
one output file will be created (single output sode) cr 
aultiple files will be created (multiple output acde) . 

The COPYFILE coaaand is used to: 

• copy one file to another 

• combine two or aore files into a single output file 

• copy files into aultiple output files 

Within these copy operations, the user can specify that the 
following actions are to be perforaed during the operation: 

• naaes of files copied aay be typed at the terainal. 

® existing output files aay be replaced by the new output 

flies. 

« the record foraat and logical record length aay he 

changed. 

e records froa the input fiie(s) aay be selectively copied 
based on either: 

a. record number. 

b. label field of record. 

• trailing fill characters aay be reacved froa each 

record. 

• an input file aay be compressed. 

• 026 key punch characters aay be converted to 

corresponding 029 characters. 

• lowercase letters aay be converted tc uppercase and 

uppercase letters aay be converted to lowercase. 

• data in an existing file aay be overlaid with selected 
data froa another file. 

• one file aay be appended to another file. 

• selected positions within each record nany fce moved to 
specified positions in the records of another file. 

• a specified character string or hexadecimal character 
aay be inserted into selected positions cf each record 
in the output file* 

• character translations aay be perforaed. 
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CLCOPYP 

00083 

CLCOPTF 

00084 

CLCOPTF 

00085 

CLCOPTF 

00086 

CLCOPTF 

00087 

CLCOPYP 

00088 

CLCOPYP 

00089 

CLCOPTF 

00090 

CLCOPYP 

00O91 

CLCOPYF 

00092 

CLCOPYF 

00093 

CLCOPYP 

00094 

CLCOPYF 

00095 

CLCOPTF 

00096 

CLCOPTF 

00097 

CLCOPTF 

00098 

CLCOPTF 

00099 

CLCOPYF 

00100 

CLCOPYF 

00101 


CLCOPYF 

00106 

CLCOPYF 

00107 

CLCOPYF 

00108 

CLCOPYF 

00109 

CLCOPTF 

00110 

CLCOPYF 

00111 

CLCOPYF 

00115 

CLCOPYP 

00115 

CLCOPYF 

00116 

CLCOPTF 

00117 

CLCOPYF 

''OH? 

CLCOPTF 

00118 

CLCOPYF 

00118 

CLCOPTF 

09119 

CLCOPYF 

00120 

CLCOPYF 

00121 

CLCOPYF 

00123 

CLCOPYP 

00124 

CLCOPTF 

00125 

CLCOPYF 

00125 

CLCOPYF 

00126 

CLCOPTF 

00127 

CLCOPTF 

00127 

CLCOPYP 

00129 

CLCOPYF 

00131 

CLCOPYF 

00132 

CLCOPTF 

00134 


COPYPILE | fileidi 1 £fileidi2... J [fileido] [(cgtiona)] 
COPI | 

| options: [TYPE! notype ] 

I C N EW£AliToLDDATE] 

| [aECP«“F|VJ J 

| [LRECL nn] 

I [flMEII NOPBOMPT ] 

| [FROM n 1 CSC | PR LABEL 1XXXXXXX ] 

j [FOB n* rec| TOLABEL xjxxxxxx] 

| [TRUNC|NOTHUNC] 

| [PACK!UNPACK] 

j [EBCDIC] 

| [UPCASE)LOWCASE] 

| fN BWFIL EiRBPLACElOVLYlAPEENE] 

j [FILL {c|nh|4£}] 

| f SPECS I N OSPEC S 1 

| [TRANS] 


fileidi 1 


fileidi2 


fileido 


specifies the first (or only) input file. 
Filename, filetype and filemode a is t all be 
specified either by indicating a specific naae 
or by coding an asterisk. Note, however, that 
all three components of fileidi 1 cannot be 
specified by asterisks. 


specifies additional input files. Filenaae, 
filetype and filesode oust all be specified. In 
single ouput filesode, any cf the three 
components say be specified by an asterisk while 
in multiple output filemode, an asterisk is 
illegal in the field. An equal (=) sign may be 
coded for any (or any part of) of the fileid 
components indicating that the component is to 
be the same as the corresponding component in 
fileidil. 

specifies the output files to be created. 
Filename, filetype and filesode must all be 
specified. To create multiple output tiles, an 
equal sign (=) must be coded in one or more of 
the component fields. If there is only one input 
fileid, fileido may be omitted, in which case it 
defaults to * * * . This causes the input file 
represented by fileidil to be replaced. 


The following options are the most used and are useful for 
most general applications. Minor variations cf these 
options are described under the heading, "Otter Options". 
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CLCOPIF 

00136 



CLCOPTF 

CLCOPYP 

00140 

00144 

TYPE 

T 

specifies that the naies of the files copied are 
to be typed at the terninal. 

CLCOPTF 

CLCOPTF 

00147 

00151 

mo ms 

NOT 

specifies that the naaes of tie files to be 

copied are not typed at the terainal. 

CLCOPTF 

CLCOPTF 

00154 

00158 

NSHDATB 

NEHD 

specifies that the creation date of the new 
files is the current date. 

CLCOPTF 

CLCOPTF 

CLCOPTF 

00161 

00165 

00166 

OLDDATB 

OLDD 

specifies that the creation date cf the new 
files is the saae as that of the first input 
file. 

CLCOPTF 

CLCOPTF 

CLCOPTF 

CLCOPTF 

00172 

00174 

00176 

00179 

r ■» 

HECFB | F | 
BBC < ? > 

L J 

specifies the record foraat of the output 

files. If not specified, the output record foraat 
is the saae as that of the input. 

CLCOPTF 

CLCOPTF 

CLCOPTF 

CLCOPTF 

00182 

00186 

00187 

00188 

LBECL DU 

LR 

specifies the logical record length of the 
output files if it is to be different fren that 
of the input files. The naxinua value of nn is 
65535. 

CLCOPTF 

CLCOPTF 

CLCOPTF 

00191 

O0192 

00193 

PROH£I 

PH 

specifies that the aessages which teguest 
specification or translation lists are to be 
displayed. 

CLCOPTF 

CLCOPTF 

00196 

00198 

NOPROMPT 

NO PR 

specifies that proapt aessages for specificaticn 
and translation lists are not to te displayed. 

CLCOPTF 

00204 

Copy Extent 

_2£li2fis 

CLCOPYP 

CLCOPYP 

00206 

00210 

PROM recno 
FB 

specifies the starting record r.unbec for each 
input file in the copy operation. 

CLCOPTF 

CLCOPTF 

CLCOPTF 

CLCOPTF 

CLCOPYP 

CLCOPTF 

00214 

00220 

00221 

00221 

00222 

"0223 

FB LA B EL 

FRL 

XXXXXXXX 

xxxxxxxx specifies a character sequence which 
will appear at the beginning of the first reccrd 
to be copied fron each input file. Up to eight 
characters aay be specified. The character 
sequence aay not contain esbedded blanks. 

CLCOPYP 

CLCOPTF 

00228 

00229 

FOB o'roe 

specifies the nunber of records tc te copied 
froa each input file. 

CLCOPTF 

CLCOPYP 

CLCOPTF 

CLCOPTF 

00234 

00237 

00238 

00238 

TO LA BEL . 

TOL 

xxxxxxxx 

xxxxxxxx specifies a character sequence which, 
if at the beginning of a record, steps the copy 
operation for that input file. The record 
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00239 

00240 

00240 

00241 


containing the given character is net copied. 
Up to eight characters aay be specified. The 
character sequence aay not ccntain eabedded 
blanks. 


00244 TSOBC 

00248 THU 

00249 


specifies that trailing blanks (or till 
characters) are to be removed when converting tc 
HECFH V output file record foraat. 


00250 

00251 

00252 


The HECFH and LBECL options can be used tc 
specify the record foraat and logical record 
lengths of the output files being created. 


00253 

00254 

00254 

00255 

00256 

00256 

00257 

"0258 


There are two record formats, E (fixed) cr V 
(variable) . Fixed record foraat files have all 
records the saae size. Typical cf such files 
are card image files, where all records are 80 
bytes long. Variable record foraat files have 
records of varying sizes. Typical of such files 
are SCRIPT files, where the length of each 
record is usually different. 


00259 

00260 

00261 


The logical record length applies only tc fixed 
record foraat (F) files. For exaaple, for card 
iaage files, the logical record length is 80. 


00262 

00263 

00264 

00264 

00265 

00265 

00266 

00267 

00268 


The default record foraat and logical record 
length are taken froa the current cr only first 
input file, and aay be overridden by the HECFH 
or LRECL options. The HECFM option is followed 
by the letter F or V, and the LRECL cption is 
followed by a deciaal nuaber giving the logical 
record length. If the output file record foraat 
is V, then the LRECL option if specified, is 
ignored. 


00269 

00270 

00271 

00271 

00272 

00273 

00273 

00274 

00275 


When the output file record foraat is F, then 
the input records are truncated or padded, if 
necessary, to the logical record length. When 
the output file record foraat is V, the input 
records are siaply copied to the output tile, 
unless the TRUNC option is specified. In the 
latter case, all blanks on the end of each 
record are removed before the record is written 
out. 


00276 

00277 

00278 


For inforaation on variations cf this eptien, 
see the discussion of the FILL opticn under 
“Other Options.“ 


00281 ' IQlBflfiC 
00284 NOTE 
00286 


specifies that trailing blanks (or fill 
characters) are not to be reaeved when 
converting to HECFH V output file record foraat. 
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CLCOPYP 

CLCOPTP 

CLCOPYP 

CLCOPYF 

CLCOPYP 

CLCOPYP 

CLCOPYP 

CLCOPYP 

CLCOPYP 

CLCOPYP 

CLCOPYP 

CLCOPYF 

CLCOPYP 

CLCOPYP 

CLCOPYP 

CLCOPYP 

CLCOPYP 

CLCOPYP 

CLCOPYP 

CLCOPYP 

CLCOPYP 

CLCOPYP 

CLCOPYP 

CLCOPYP 

CLCOPYF 

CLCOPYP 

CLCOPYF 

CLCOPYP 

CLCOPYP 

CLCOPYF 

CLCOPYF 

CLCOPYP 

CLCOPYF 

CLCOPYP 

CLCOPYP 

CLCOPYF 

CLCOPYP 

CLCOPYP 

CLCOPYP 

CLCOPYP 

CLCOPYP 

CLCOPYP 

CLCOPYP 

CLCOPYP 

CLCOPYF 

CLCOPYP 

CLCOPYP 


00290 PACK 

00293 PA 

00294 

00295 

00295 

00296 

00297 

00297 

00298 

00299 

00300 


specifies that repetitively recurring 
characters are to be converted to ccapressed 
foraat. If the PILL option is not used, all 
occurrences of two or more blanks in the file 
are encoded as one character, and four or or 
■ore occurrences of any other character in the 
file are encoded as three characters. If a FILL 
character is specified, that character replaces 
the blank as the special packing character, and 
blanks are treated as any ether non-fill 
character. 


00301 

00302 

00302 

00303 

00303 

00305 


Source files generally take up a great deal of 
disk space, largely because they contain a great 
aany blanks. This is particularly wasteful in 
the case of source files which are seldoa 
needed, but nust be kept iwnediately available 
for the few tines that they are needed. 


00306 

00307 

00307 

00308 

00308 

00309 


By using the PACK option of the CCPYFILE 
coaaand, the user nay cause the systea to encode 
his file in a special way so that aultiple 
blanks are represented as a single character, 
and aultiple occurrences of other characters 
also produce space savings. 


00310 If the PACK option is specified, then the output 
00311 file will be in a special foraat which can be 
00311 decoded only by the UNPACK eptien of the 
00312 COPYFILE coaaand. 


00313 As an exaaple of the use of this option, the 

00314 following coaaand: 


00317 


COPYFILE * ASSEMBLE At (PACK 


00319 causes all ASSEMBLE files on the A-disk to be 

00320 packed. 


00321 

00322 

00322 

00323 

00324 

00324 

00325 

00326 

00326 

00327 

00327 

00328 

00329 

00329 

00330 


In the encoding process, all occurrences of twe 
of nore blanks in the file are encoded as one 
character, while four or acre ccnsecutive 
occurrences of any other character in the file 
are encoded as three characters. It is clear, 
therefore, that the greatest savings are aade 
with respect to coapressing blank characters. 
If the user knows that his file contains a 
preponderance of soae other character, far acre 
often then blanks, then he nay specify that 
character with the FILL opticn, and that 
character will replace the blank as the "special 
packing character." Of course, feur or acre 
blanks will still be coapressed, as will any 
other character. (The FILL eptien is discussed 
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CLCOPIF 

00331 

CLCOPYF 

00332 

CLCOPTF 

00333 

CLCOPTF 

00333 

CLCOPTF 

00334 

CLCOPTF 

00335 

CLCOPTF 

00336 

CLCOPYF 

00337 

CLCOPTF 

00337 

CLCOPTF 

00338 

CLCOPTP 

00339 

CLCOPYF 

00340 

CLCOPTF 

00343 

CLCOPTF 

00347 


CLCOPTF 

00350 

CLCOPYF 

00354 

CLCOPTF 

00358 

CLCOPTF 

00358 

CLCOPTF 

00359 

CLCOPTF 

00360 

CLCOPYF 

00362 

CLCOPTF 

00364 

CLCOPTF 

00366 

CLCOPTF 

00368 

CLCOPTF 

00370 

CLCOPTF 

00372 

CLCOPTF 

00376 

CLCOPTF 

00380 

CLCOPTF 

00380 

CLCOPTF 

00381 

CLCOPYP 

00384 

CLCOPTF 

00388 

CLCOPTF 

00388 

CLCOPYF 

00389 


CLCOPTF 

00393 

CLCOPTF 

00395 

CLCOPTF 

00396 

CLCOPTF 

00397 


under "Other Options".) 

Mote, however, that not every file should be 
packed. In fact, if the file dees not contain 
very nany occurrences of aulti[le characters, 
then it is possible for the packed file to be 
longer than the original file. 

WABHIM Gs A file in packed fornat should not be 
aodified or tampered with in any way. If such a 
file is sodified in any way, then the UNPACK 
routines will be unable to reconstruct the 
original file. Packed files should never be 
coabined or split apart in any way. 

UNPACK specifies that the PACK operation is to be 
UNP reversed. 


Character Translat io n Option s 


EBCDIC specifies that the file was created with 026 

EB keypunch characters (BCD) , and that all such 

characters are to be converted to C29 keypunch 
characters (EBCDIC)• The following conversions 
are Bade: 

< to ) 

6 to ♦ 

X to ( 

# to = 

9 to • 

• to : 

UPCASE specifies that all lowercase characters in each 

UP record t.o be written to an output file are to be 

converted to uppercase before the record is 

written out. 

LOHCASE specifies that all uppercase characters in each 

LO record to be written to an output file are to be 

converted to lowercase before the record is 

written out. 


0£h§£-SL£tioa2 


In addition to the options already described, the CCPYFILE 
coaaand offers several sore coupler variatiens, which allow 
sore flexibility in the copy operation. 
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CLCOPYF 

00399 


CLCOPYF 

00402 

NEWF 

CLCOPYF 

00403 


CLCOPYF 

00404 


CLCOPYF 

00404 


CLCOPYF 

00406 


CLCOPYF 

00409 


CLCOPYP 

00410 

REPLACE 

CLCOPYF 

00413 

REP 

CLCOPYF 

00414 


CLCOPYF 

00415 


CLCOPYF 

00416 


CLCOPYF 

00419 

OVLY 

CLCOPYF 

00423 

OY 

CLCOPYF 

00426 

APPEND 

CLCOPYP 

00429 

AP 

CLCOPYF 

00430 


CLCOPYF 

00431 


CLCOPYF 

00434 

FILL c 

CLCOPYF 

00436 

FI hh 

CLCOPYP 

00440 


CLCOPYF 

00440 

CLCOPYF 

00441 


CLCOPYF 

00442 


CLCOPYF 

00443 


CLCOPYF 

00444 


CLCOPYF 

00445 


CLCOPYF 

00446 


CLCOPYF 

00446 


CLCOPYF 

00447 


CLCOPYF 

00447 


CLCOPYF 

00449 


CLCOPYF 

00450 


CLCOPYF 

00451 


CLCOPYF 

00451 


CLCOPYF 

00452 


CLCOPYF 

00453 


CLCOPYF 

00453 


CLCOPYF 

00454 


CLCOPYF 

00455 


CLCOPYF 

00456 


CLCOPYF 

00457 


CLCOPYP 

00458 


CLCOPYF 

00458 


CLCOPYF 

00459 


CLCOPYF 

00460 



if this option is in effect, the output files 
aust not have previously existed. If one or 
aore do exist an error message is typed and the 
COPYFILE conaand terminates. This option is the 
default so that the user cannot inadvertently 
destroy an existing file on his disk. 


specifies that only files with the same file- 
identifiers as those being created by tne 
COPYFILE command are to be erased and new ones 
created. REPLACE is the default option only 
when the output file identification is " = = = 

specifies that data in an existing output file 
is to be overlaid with data froa the input tile. 

specifies that data from the input file is to 
be appended to the end of a file specified ty 
the output file identifier. If no output file 
exists, one is created. 

specifies the padding and truncation character 
or the principal packing character for the 
PACK option. It may be specified ty typing a 
single character, ‘c’, or by typing a two-digit 
hexadecimal representation of a character. The 
default is 40 (the hexadecimal representation 
for a blank in EBCDIC) . 

when the output file record format is F, then 
the input records are truncated or padded, if 
necessary, to the logical record length. The 
padding and truncation character is usually a 
blank, but this default may be cverridden by 
means of the FILL option, to specify a new 
padding and truncation character. 

When the output file record format is V, then 
the input records will simply be copied to the 
output file, unless the TRONC option is 
specified. In the latter case, all blanks on the 
end of each record are removed before the record 
is written out. If it is desired to truncate 
some character other then blanks, then the Fill 
option may be used. 

The PACK routine treats the blank as a "special 
packing character", and makes the greatest 
savings with respect to multiple cccurcences of 
that character. If desired, the f ILi option may 
be used to change the "special packing 
character" to any desired Character, 
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CLCOPYF 

00464 

CLCOPYF 

03467 

CLCOPYF 

00469 

CLCOPYF 

00470 

CLCOPYF 

00471 

CLCOPYF 

00471 

CLCOPYF 

00472 

CLCOPYF 

00473 

CLCOPYF 

00474 

CLCOPYF 

00476 

CLCOPYF 

00477 

CLCOPYF 

00478 

CLCOPYF 

00479 

CLCOPYP 

00480 

CLCOPYF 

00485 

CLCOPYF 

00486 

CLCOPYF 

00487 

CLCOPYF 

00492 

CLCOPYF 

004 94 

CLCOPYF 

00495 

CLCOPYF 

00495 

CLCOPYF 

00496 

CLCOPYP 

00497 

CLCOPYF 

00497 

CLCOPYF 

00498 

CLCOPYF 

00498 

CLCOPYF 

00499 

CLCOPYF 

00499 

CLCOPYP 

00501 

CLCOPYF 

00505 

CLCOPYF 

00507 

CLCOPYF 

00508 

CLCOPYF 

00508 

CLCOPYF 

03510 

CLCOPYF 

00510 

CLCOPYP 

00512 

CLCOPYF 

00512 

CLCOPYP 

09513 

CLCOPYF 

00513 

CLCOPYF 

00515 

CLCOPYP 

00519 

CLCOPYF 

00522 

CLCOPYF 

00522 


SPECS 

SP 


specifies that the user is to he asked fcr a 
specification list which defines the tanner in 
which data is to be copied. 

Use of the SPECS option causes the COPYFILE 
coaaand to request a specification list that 
defines the way in which the output tecords are 
to be foraed. 

If the SPECS option is used, then CCPYFILE 
issues the following prcapting aessace: 

DNSCPY601B ENTEfi SPECIFICATION LIST 

The keyboard unlocks, and the ueer aay type in 
the specification list. 

The foraat of the specification list is as 
follows: 

source target <source target> ..'. 

The source specification aay be any one of the 
following: 

a. A pair of coluans of the input file, 
specified in the foraat "nn-n", two deciaal 
nuaber values separated by a hyphen. This 
foraat is used to cause the specified coluans 
of the input file to be copied to the output 
file. For each record that is copied, the 
value of aa is coapardd with the length of 
the record. If it is larger, then it is 
truncated to the record length. For exaaple, 
the source specification "23-43" causes 
coluans 23 through 40 of the input file 
record to be copied to the output file. 

b. A string of characters, deliaited by 

non-alphaaeric characters. Such a 

specification causes the specified string cf 
characters to be placed in the output file 
record. For exaaple, a source specificaticn 
of "/AbCd 1234/" causes the string "AtCd 
1234" to be placed in each record cf the 
output file. The letters in the string of 
characters are not autoaatically raised to 
uppercase; if the user wishes capital 
letters, he aust type thea in as such. 

c. A string of characters, specified by the 
letter "H" followed by an even nuaber of 
hexadecimal digits entered usitg nuaeric 
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CLCOPTF 

00523 

CLCOPYF 

00524 

CLCOPTF 

00524 

CLCOPYF 

00526 

CLCOPYF 

00526 

CLCOPYF 

00527 

CLCOPYF 

00527 

CLCOPYF 

00527 

CLCOPYF 

00528 

CLCOPYF 

00529 

CLCOPYF 

00532 

CLCOPYF 

00533 

CLCOPYF 

00534 

CLCOPYF 

00535 

CLCOPYF 

00536 

CLCOPYF 

00540 

CLCOPYF 

00541 

CLCOPYF 

00542 

CLCOPYF 

00542 

CLCOPYF 

00543 

CLCOPYF 

00543 

CLCOPYF 

00544 

CLCOPYF 

00545 

CLCOPYF 

00545 

CLCOPYF 

00546 

CLCOPYF 

00546 

CLCOPYF 

00548 

CLCOPYF 

00549 

CLCOPYF 

00550 

CLCOPYF 

00550 

CLCOPYF 

00551 

CLCOPYF 

00551 

CLCOPYF 

00553 

CLCOPYF 

00554 

CLCOPYP 

00554 

CLCOPYF 

00555 

CLCOPYF 

00555 

CLCOPYF 

00556 

CLCOPYP 

00557 

CLCOPYP 

00557 

CLCOPYP 

00558 

CLCOPYF 

00559 

CLCOPTF 

00560 

CLCOPYF 

00560 

CLCOPYF 

00561 

CLCOPYF 

00561 

CLCOPYF 

00562 


characters and either upper cc lower care 
alphabetic characters. This type of 
specification is useful when type *b w 
described in the preceding paragraph is 
unusable because the desired string contains 
characters which cannot be typed. For 
example, the specification, M hb7c1ff H causes 
the characters given by the hexadecimal 
values X•B7*, X'C1», and X*Ff* to be placed 
in the output file. 

The target specification has only one format: a 
deciaal nuaber value representing a coluan 
number in the output record. 

For exaaple, consider the following 
specification list: 

1-5 10 *ABC* 3 *XYZ* 20 HOC 25 

This specification list contains four sets of 
specifications, and causes data to be placed 
into the output record in the following Banner: 
First, coluans 1 through 5 of the input record 
are placed in coluans 10 'thrcugh 14 of the 
output record. Next, the characters M AEC W are 
placed in coluans 3 through 5 of the output 
record. Next, the characters M JYZ" are placed 
in coluans 20 through 22 of the output record. 
Finally, the character X»00* is placed in ccluan 
25 of the output record. 

If the RECFN of the output file is V, then the 
length of the output record is deternined by the 
position of the rightmost byte cf data that was 
placed into the output record. If the RECFM of 
the output file is F, then the record is padded 
or truncated to the logical record length. 

Coluans of the output record for which no data 
is specified are filled with blanks. If sons 
other character is desired, then the FILL opticn 
aay be used to specify a different character. 
In the exaaple shown above, ccluans 1-2, 4-9, 
15-19 and 23-24 of the output file record will 
contain blanks. In addition, if the output 
record foraat is F, then there will be blanks in 
coluans 26 through to the end of the record. 

The SPECS option is particularly useful in 
conjunction with the OVLY opticn. If these 
options are used together, then the 
specification list specifies how the cutput file 
record is to be overlaid. For exaaple, if the 
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00562 
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00563 
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00565 


CLCOPYF 

00566 


CLCOPYF 

00567 


CLCOPYF 

00567 


CLCOPYF 

00568 


CLCOPYF 

00568 


CLCOPYF 

00569 


CLCOPYF 

00570 


CLCOPYF 

00573 

HOSEJSS5 

CLCOPYF 

00577 

NOSP 

CLCOPYF 

00580 

TRANS 

CLCOPYF 

00583 

TRA 

CLCOPYF 

00584 


CLCOPYF 

00585 


CLCOPYF 

00586 


CLCOPYF 

00587 


CLCOPYF 

00587 


CLCOPYF 

00588 


CLCOPYP 

00588 


CLCOPYF 

00589 


CLCOPYF 

00590 


CLCOPYF 

00591 


CLCOPYF 

00592 


CLCOPYF 

00594 


CLCOPYF 

00595 


CLCOPYF 

00596 


CLCOPYF 

00597 


CLCOPYF 

C 0598 


CLCOPYF 

00598 


CLCOPYF 

00599 


CLCOPYF 

00599 


CLCOPYF 

00600 


CLCOPYF 

00601 


CLCOPYF 

00602 


CLCOPYF 

00603 


CLCOPYF 

00605 


CLCOPYF 

00606 


CLCOPYF 

00607 



specification list "1-10 20" were used with the 
OVLY option, then columns 1-10 cf each input 
file record would overlay columns 2C-29 cf each 
record of the existing output file, and the 
other columns of the output file records would 
remain unchanged. 


The specification list can be continued cntc 
additional lines by typing at the end of 
the first line. When these two characters are 
encountered when a source-specificaticn is 
expected, all scanning of that line ceases, and 
the keyboard unlocks so that a tew line may be 
entered. 


indicates that the user does not wish to enter a 
specification list. 

specifies that the user is to be asked for a list 
of character conversions which are to be made as 
the file is copied. 


The TRANS option allows the user to specify his 
own list of translations. If specified in 
conjunction with any of the other three 
translation options (UPCASE, LOWCASE cr EBCDIC) r 
then the user's list will override any 
individual translations specified by those 
options. 


If the TBANS option is specified, 
COPYFILE command types out the 
message: 


then the 
prompting 


DMSCPY602R ENTER TRANSLATION IIST 


and unlocks the keyboard. The user xay then 
enter his translation list. 


The translation list consists of as many pairs 
of characters as the user desires, separated ty 
blanks. Each character nay be specified either 
by typing the character itself or ty typing a 
two-digit hexadecimal equivalent (the latter is 
particularly useful for characters which cannot 
be typed). 


For example, the following translation list nay 
be typed in: 

« - A CO 00 Cf 


This translation list specifies that the 
character is to be translated tc *-*, the 
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character 'A* la to be translated to JC'PO*, and 
the character X*00* is to be translated to 
X'FF'. If the preceding translaticn list had 
been specified in conjunction with the LOWCASE 
option, then the translation 'A* to X'FO* would 
override the LOWCASE translation, 'A' tc 'a*. 

The translation list can be continued onto 
additional lines by typing as the last two 

characters of the present line* When these two 
characters are encountered where the first 
character of a character pair is expected, then 
all scanning of that line ceases, and the 
keyboard unlocks so that a new line say be 
entered. 


CLCOPI2 

00004 



CLCOPY2 

CLCOPY2 

00006 

00008 

Figure 16 shows combinations of options which say 
specified together in the same COPYFILE coaaand. 

not be 

CLC0PY2 

CLCOPY2 

00009 

00011 

If the option in the first column is specified, nene 
options in the second column nay be coded. 

of the 


CLCOPYF 

CLCOPTF 

CLCOPYF 

CLCOPYF 

CLCOPYF 

CLCOPYF 


00607 

00608 

00609 

00610 

00611 

00612 


CLCOPYF 

CLCOPYF 

CLCOPYF 

CLCOPYF 

CLCOPYF 

CLCOPYF 

CLCOPYF 

CLCOPYF 


00613 

00614 

00615 

00616 

00616 

00617 

00617 

00618 
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CLCOPY2 

CLCOPY2 

CLCOPY2 

:lcopy2 

CLCOPY2 
CLCOPY2 
CLCOPY2 
CLCOPY2 
CLCOPY2 
CLCOPY2 
Z LCOPY 2 
CLCOPY2 
CLCOPY2 
CLCOPY2 
CLCOPY2 
CLCOPY2 
CLCOPY2 
CLCOPY2 
CLCOPY2 
CLCOPY2 
CLCOPY2 
CLC0PY2 
CLCOPY2 
CLCOPY2 
CLCOPY2 
CLCOPY2 
CLCOPY2 
CLCOPY2 
CLCOPY2 
CLCOPY2 
CLCOPY2 
CLCOPY2 
CLC0PY2 

CLCOPY2 


CLCOPY2 


CLCOPY2 

CLCOPY2 

CLCOPY2 

CLCOPY2 

CLCOPY2 


00020 

r 


. .— ——----- ---— -- 

— 1 

00021 

i 

TYPE 

| NOTYPE 


00022 

i 

NOTYPE 

j TYPE 


00023 

i 

NEWDATE 

| OLDDATE. APPEND 


00024 

i 

OLDDATE 

| NEWDATE. APPEND 


00025 

i 

RECFM 

| PACK. UNPACK. APPEND 


00026 

i 

LRECL 

| PACK. UNPACK. APPEND , 


00027 


PROMPT 

| NO PROM PT 


00028 

i 

NO PROMPT 

| PROMPT 


00029 

i 

FROM 

| FRLABEL. PACK. UNPACK 


nn030 

i 

FRLABEL 

| FROM, PACK, UNPACK 


00031 

i 

FOR 

| TOLABEL, PACK, UNPACK 


00032 

i 

TOLABEL 

| FOR, PACK, UNPACK 


00033 

i 

TR0NC 

| NOTRUNC, PACK, UNPACK 


0 00 34 

! 

NOTRUNC 

| TRUNC, PACK, NOPACK 


00035 

00036 

00037 

1 

1 

1 

PACK 

1 BECFM, LRECL, TRUNC, UNPACK, EECEIC, UPCASE, 

| LOWCASE, OVLY, APPEND, SPECS, TBAKS, FRCM 
] FRLABEL, FOR, TOLABEL 


00038 

1 

UNPACK 

1 BECFM, LRECL, TRUNC, PACK, EECEIC, UPCASE, 


00039 

00040 

1 

I 


9 LOWCASE, OVLY, APPEND, SPECS, TBAKS, FROM, 
g FRLABEL, FOR, TOLABEL 


C 004 1 

1 

EBCDIC 

g PACK, UNPACK 


00042 

1 

UPCASE 

| PACK, UNPACK 


00043 

• 

LO0CASE 

S PACK, UNPACK 


00044 


NEWFILE 

g REPLACE, OYLY, APPEND 


00045 

i 

REPLACE 

g NEWFILE, OYLY, APPEND 


00046 

1 

OVLY 

| NEWFILE, REPLACE, APPEND, PACK, UNPACK 


00C47 

00048 

1 

APPEND 

| NEWDATE, OLDDATE, RECFM, LRECL, NEWFILE, REPLACE, 
S OVLY, PACK, UNPACK 


00049 

1 

SPECS 

( PACK, UNPACK, NOSPECS 


00050 

1 

NO SPECS 

| PACK, UNPACK, SPECS 


00051 

00052 

1 

L 

TRANS 

t PACK, UNPACK 

— J 


0OP55 Figure 16. COPYPILE Option Incompatibilities 


00061 Example 1 


00068 f l. m ■— — .1 . — ■■■ . — I I H I III -I, — Ill < ■ - — ■ II I ■■ 

00069 J COPYFILE OLD FILE A1 NEW FILE A1 | 

00070 i-■----—;- j 

00073 Acti on: This command copies the file OLD FILE II to a new 

00075 file created by this command and named NEW FILE A1. 


ei 
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CLCOPT2 


CLCOPY2 

CLCOPY2 

CLCOPY2 

CLCOPT2 

CLCOPY2 

CLCOPY2 

CLCOPY2 

CLCOPY2 


CLCOPY2 


CLCOPY2 

CLCOPY2 

CLCOPY2 

CLCOPI2 

CLCOPY2 

CLCOPY2 

CLCOPY2 

CLCOPY2 

CLCOPY2 


CLCOPY2 


CLCOPY2 
CLCOPY2 
CLCOPY 2 

CLCOPT2 
CLCOPY2 


CLCOPY2 


CLCOPY2 
CLCOPY2 
CLCOPY2 


CLCOPY2 
CLCOPY2 


00078 


Exaaple 2 


00080 

00082 

00083 


COPYFILE 


* FILE A1 


BIG FILE A1 


1 

_j 


00086 Acti on: This coaaand copies all £iles with filetype of FILE 
00087 and fileaode of A1 and coabines thea into a single output 
00088 file naaed BIG FILE Al. If the user has files A FILE Al, B 
00089 FILE Al and C FILE Al, they are copied to EIG FILE Al and 
00090 are not erased. 


00094 


Example 3 


00096 

00098 

00104 

00107 

00108 

00109 

00110 

00111 

00112 


00115 


00118 

00119 

00120 

00123 

00124 


00127 


00129 

00131 

00137 


1-■—- 

I COPYFILE OLD * B1 NEK 

— **■» 
« El | 

Action: This coanand copies a group of files, each of which 
has a filetype of OLD and a fileaode of Bl tc a new group cf 
files each with a filetype of NEW and a fileaode of El. If 
the user has files naaed OLD NAME Bl, OLD EIBTECA Bl, OLD 
ADDBESS Bl, they will be copied respective!) to files naaed 
NEW NAME Bl, NEW BIHTHDA Bl, and NEW ADDRESS Bl. 

Exaaple 4 


\ COPYFILE X Y Al P Q AD BIG 

*-.- ..- - - - -,- r - - _ - ., - 

FILE Al 1 

Action: This coaaand coabines files X Y 
single output file naaed BIG FILE Al. 

At and E ( 11 into a 

Example 5 


1 COPYFILE X * Al * i 

•— 

FILE = j 


00140 Agiiflfl: All files with a filenaae of I and a fileacde of Al 

00142 are combined into a single output file naaed x FILE Al. 
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CLCOPY2 00150 Exaaple 6 


CLCOPY2 00152 ,--t 

CLCOPY2 00153 | COPIFILE X * A1 * T A1 BIG FIL1 Al | 

CLCOPY2 00154 «--• 


CLCOPY2 00157 AstiSfiJ All £iles with filenaae X and fileaode A1 ace 
CLCOPY2 00158 conbined with all files with a filetype T and fileaode Al to 
CLCOPY2 00159 fora a single file naaed BIG FILE 11. This ccaaand could 
CLCOPY2 00160 also have been entered as: 

CLCOPY2 00162 COPYFILE X * 11 ■ T * BIG FILE * 


CLCOPY2 00164 Exaaple 7 


CLCOPY 2 00166 ,------ n 

CLCOPY2 00167 j COPYFILE X * 11 P Q 11 BIG ■ Al J 

CLC0PY2 00168 »--J 


CLCOPY2 00172 Ac tj on: Each file with a filenaae of X and a fileacde of Al 
CLCOPY2 00173 is coabined with P Q Al to create a file naaed BIG * Al. Cce 
CLCOPY2 00173 file is created for each existing file with a filenaae x and 
CLCOPY 2 00174 fileaode 11. 


CLCOPY2 00177 Exaaple 8 


CLCOPY 2 00179 ,---- 

CLCOPY 2 00180 | COPYFILE X * Al P = Al BIG * 11 | 

CLCOPY2 00181 •--> 


CLCOPY2 00184 Acti on: Each file with a filenaae of X and a fileaode of 11 
CLCOPY2 00185 is coabined with a file with a filenaae of E and a fileaode 
CLCOPY2 00186 of Al and a filetype corresponding to that of the first 
CLCOPY2 00187 input file to produce a file with a filenaae of BIG. a 
CLCOPY2 00188 corresponding filetype. and a fileaode of Al. This coaaand 
CLCOPY2 00189 could also have been entered as: 

CLCOPY2 00191 COPYFILE I * Al P * * BIG - - 
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CLCOPI2 


CLCOPY2 

CLCOPY2 

CLCOPT2 


CLCOPY2 

CLCOPY2 


CLCOPY2 


CLCOPY2 

CLCOPY2 

CLCOPY2 


CLCOPY2 

CLCOPY2 


CLCOPY2 


CLCOPY2 

CLCOPY2 

CLCOPY2 


CLCOPY2 

CLCOPY2 

CLCOPY2 

CLCOPY2 


CLCOPY2 


CLCOPY2 
CLCOPY2 
CLCOPY2 


CLCOPY2 

CLCOPY2. 


9 


00194 Exaaple 9 


00196 

00197 

00198 


00201 

00202 


00204 


00207 

00208 

00209 


00212 

00214 


00216 


00218 

00219 

00220 


00223 

00224 

00224 

00227 


00229 


00231 

00232 

00233 


i COPY FILE BIG NAME A A1 

XYZ- *■ * 

. ) 

Action: File BIGNANE A A1 

XYZBIGHA AA Al. 

is copied tc a 

file naaed 

Exaaple 10 



{ COPYPILE A B Al C 

D Al (FBCi! 10 

fGB 25) ] 

Twenty five records are copied frca file 
file C D Al, beginning with the tenth record of A 

A E Al to 

B Al. 

Example 11 



| COPIFILE OLD B A? HEW B Al 

a_ 

(FBLABEL MYPFOG TCLABIL FINIS) 

Action: Becords are copied froa file CLD B 11 to NED £ Al. 
Copying begins with a record containing the characters 
'HYPBOG' and continues until a record containing the 
characters 'FINIS' is encountered* 

Exaaple 12 



1 COPYFILE * ASSEMBLE * 

(PACK 

1 


00236 Action : All files with a filetype of ASSEMBLE are converted 
00237 to packed foraat. 
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CLCOPY2 


CLCOPY2 

CLCOPY2 

CLCOPY2 


CLCOPY2 

CLCOPY2 

CLCOPY2 

CLCOPY2 

CLCOPY2 

CLCOPY2 

CLCOPY2 

CLCOPY2 

CLCOPY2 

CLCOPY2 

CLCOPY2 

CLCOPY2 

CLCOPY2 

CLCOPY2 

CLCOPY2 

CLCOPY2 

CLCOPY2 

CLCOPY2 


CLCOPY2 


CLCOPY2 

CLCOPY2 

CLCOPY2 


CLCOPT2 

CLCOPY2 

CLCOPY2 


00239 Exaaple 13 


00241 ,--1 

00242 j COPYFILE MY PILE Al YOUR PILE A1 (SEECS j 

00243 , »---—--- J 


00246 The file naaed MY FILE Al is to be ccpi€d tc a new 

00247 file naaed YOUR PILE Al and is to be acdified according to 

00243 certain specifications before the new file is written. The 

00249 following aessage types at the terainal: 

00251 DMSCPY601E ENTER SPECIFICATION LIST 

00252 The keyboard unlocks so that the specification list can be 

00253 entered. 

00254 For exaaple, if the following specification list were 

00255 entered: 

00257 1-5 10 /ABC/ 3 H00 1 

00258 Positions 1-5 of the input record will be copied to 

00259 positions 10-14 of the output record, the character string 

00260 "ABC" will be placjed in positions 3-5 of the output record, 

00261 and the character 1*00* will be placed in the first position 

00262 of the output recjord. All other positions in the record 

00263 will contain blankls Unless a FILL character is specified, in 

C 0263 which case the FILL character will be placed in all 

00264 unspecified positions. 


00266 Exaaple 14 


00268 r ------- 

00269 | COPYFILE OLD FORM Al NEW FORM Al (SPECS OVLY | 

00270 »---J 


00274 Actio n: The output file already exists and is to be overlaid 
00275 with certain portions of the input record or character 
00276 strings specified in a specification list. 
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CLCOPT2 00260 Resp o nses 

CLCOPY2 00283 DMSCPY601R ENTER SPECIFICATION LIST: 

CLCOPY2 00285 This aessage requests the specification list bhich is to be 

CLCOPY2 00286 entered in conjunction with the SPECS option* 

CLCOPY2 00288 DMSCPY602R ENTER TRANSLATION LIST: 

CLCOPY2 00290 This sessage ' requests the translation list which is to be 

CLCOPY2 00291 entered in conjunction with the TRANS option. 

CLCOPY2 00297 DMSCPY721I COPY • f n ft fl» (TO | APPEND! OVLY} » fn ft fs* H«*DjNEHj FILE) 

CLCOPI2 00301 This sessage appears in conjunction with the TYPE option. 

CLCOPY2 00303 It indicates the naees of the input file and output file. 
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CLCPPONC 


CLCPPONC 

CLCPFUNC 

CLCPFUNC 

CLCPFONC 

CLCPFUNC 

CLCPFUNC 

CLCPFUNC 
CLCPFUNC 
CLCPFUNC 
CLCPFUNC 
CLCPFUNC 
CLCPFUNC 


CLCPPONC 


CLCPFUNC 


CLCPFONC 

CLCPFUNC 
CLCPPONC 
CLCPPONC 

CLCPPONC 

CLCPPONC 


OOOON ££ 


00007 The CP coaaand transmits coaaands to the VM/370 control 
00008 program environment without forcing the user to leave the 
00009 CHS environment. 

00019 ,- 

00021 | CP J [ line ] 

00023 »- 



00028 

00029 

00029 

00030 

00030 

00031 


line any of the CP coaaands which are permitted for the 
user's CP coaaand privilege class. If this field is 
oaitted the user is placed in CP aode and aay then 
enter CP coaaands without the. H CP" preceding the 
coaaand. To return to CMS, he aust enter the CP 
coaaand BEGIN. 


00037 Respo nses 


00039 All responses are froa the CP coaaand which tas issued. 


00041 Example 

00043 ,-- 

00044 | CP TERMINAL LINESIZE 80 | 

00045 «-• 

00046 Action : The TERMINAL coaaand will be passed tc the ccntrol 
00050 progcaa for processing. 
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CLDDB 00008 fififi 


CLDD8 

00010 

CLDDR 

00013 

CLDDR 

00014 

CLDDR 

00016 

CLDDR 

00017 

CLDDR 

00019 

CLDDR 

00020 

CLDDR 

00021 

CLDDR 

00022 

CLDDR 

00025 

CLDDR 

00027 

CLDDR 

00037 

CLDDR 

00038 

CLDDR 

00039 

CLDDR 

00044 

CLDDR 

00045 

CLDDR 

00045 

CLDDR 

00047 

CLDDR 

00050 

CLDDR 

00050 

CLDDR 

00051 


CLDDR 

00053 

CLDDR 

000 54 

CLDDR 

00055 

CLDDR 

00056 

CLDDR 

00057 

CLDDR 

00*60 

CLDDR 

*0061 

CLDDR 

00062 

CLDDR 

*0063 

CLDDR 

00C64 

CLDDR 

00065 

CLDDR 

00066 

CLDDR 

00067 


The DDR coanand provides the uses with the ability to: 

1. Save data £roa direct access storage devices cn 
aagnetic tape. 

2. Restore data which has been saved on aagnetic tape to a 
direct access storage device. 

3. Copy data froa one device to another device of the saae 
type. Data nay be reordered on a cylindec basis. A 
tape-to-tape copy nay be done on data saved by this 
progran. 

4. Print specified records. 

5. Type specified records at the terninai. 


rDDR | [fn ft [fa]] ? 

i__—i 

fn ft fn specifies the file identifier ot a file which 
contains DDR control stateaents. If no file 
identifier is given, the user is requested to 
enter control stateaents at the terninai. 


fiDR C ontrol State a ents : These stateaents nay be either be 
in an existing file or they nay be entered :at the terninai 
during execution. 


I/O Definition Sjaieagjits 


INPUT or OUTPUT card - used to describe all tape and DASC 
units used. For DUMP, RESTORE, and COPY eperatiens, cne 
INPUT and one OUTPUT card is required. For EBINT and TYPE 
operations, only an INPUT card is required* 




r 

r -i 

i 9 


r i 

8 

j REMIND 1 

1 1 

INPUTIOUTPUT 

ecu type |volser| 

I ([SKIP 

xx ][ MODE den ]1 UNLOAD | 

) 1 1 

IN jOUT 

; altapel 

1 

ILEAVE | 

1 1 


8. A 

1 

i 

i j 

9 1 

j | 
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CLDDR 

CLDDR 

"0072 

00074 

INPOT 

IN 

specifies that the device described is tc he used 
as the input device. 

CLDDR 

CLDDR 

00077 

00080 

OOTPOT 

OOT 

specifies that the device described is tc fce used 
as the output device. 

CLDDR 

00083 

ecu 

specifies the unit address of the device. 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

00085 

00086 

00085 

00088 

type 

specifies the device type. Accepted values for 
DASD are 2314, 2319, 3330, and 2305-2. Accepted 
values for tape are 2400, 2420, and 3420 (7 track 
tapes are not supported). 

CLDDR 

CLDDR 

00090 

00091 

volser 

specifies the volune serial nunber of a DASD 
device. 

CLDDR 

CLDDR 

CLDDR 

00093 

00094 

00095 

altape 

specifies the address of an altercate tape drive 
to be used if nore than one tape is involved in 
the operation. 

CLDDR 

00098 

Options 


CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

00099 

00101 

00101 

00102 

00103 

Options, which apply only to tape, nay fce specified without 
a ecu, type, and altape, implying that only the tape 
specifications are to be changed. All options specified in 
a previous INPUT or OUTPUT card renain in effect unless 
overridden. 

CLDDR 

CLDDR 

CLDDR 

00106 

00110 

00111 

SKIP XX 
SK 

specifies that the tape is to be fciuatd spaced 
xx files, xx is set to zero when the tape is 
repositioned. 

CLDDR 

CLDDR 

00114 

00115 

NODE den 
HO 

specifies the density and node settings for an 
output tape. 

CLDDR 

CLDDR 

CLDDR 

00118 

00119 

00120 


dea 124® 4§a§i£i 

1600 9 track 1600 BPI 

16 

CLDDR 

CLDDR 

00122 

00124 


800 9 track 800 BPI 

8 

CLDDR 

CLDDR 

00128 

00130 

REWIND 

RE 

specifies that the tape is to cewound at the 
coaplefion of the current function. 

CLDDR 

CLDDR 

00133 

00135 

UNLOlfi 

UN 

specifies that the tape is to be unleaded at the 
coapletion of the current function. 

CLDDR 

CLDDR 

CLDDR 

00138 

00141 

"0142 

LEAVE 

LE 

specifies that the tape is to be [ositioned after 
the tape nark at the coapletion of the current 
function. 

CLDDR 

CLDDR 

00145 

00146 

SYSPRINT 
used in 

card - used to describe a printer device, it is 
conjunction with the PB1NT function and the DUMP, 
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CLDDR 

00147 

RESTORE, 

and copy functions. 




CLDDR 

00150 


- 1 




CLDDR 

00151 

| SI SPRINT | ecu | 




CLDDR 

00152 

| SY 

1 1 




CLDDR 

00153 

i___ 

__i 




CLDDR 

00157 

ecu 

specifies the virtual 

address 

of 

the device which 

CLDDR 

00158 


is to receive printer 

output. 

If 

this card is net 

CLDDR 

00159 


included, output is 

directed 

to 

the printer at 

CLDDR 

00160 


address 90E. 





CLDDR 

00163 

Function Cofttroj stateaents 

CLDDR 

00164 

The (DOHPJCOPY1 RESTORE) card describes the extents of the 

CLDDR 

00165 

operation 


n t nnn 

00168 



v Ll/I/ ti 

CLDDR 

00169 

• - - " “ 

1 

I r 

CLDDR 

00170 

| DUHPJCOPYI RESTORE | |cyl1 [TO][cyl2 [REORtEB] [TC]£cyl3]] 

CLDDR 

00171 

| DO CO 

HE | | 

CLDDR 

00172 

1 

J <CP?OL 

CLDDR 

00173 

1 

1 1 

CLDDR 

00174 

1 

| | ALL 

CLDDR 

00175 

1 

1 «• 

tt nnR 

0 0176 

t - _ 


Lt u u n 

CLDDR 

00181 

DUMP 

specifies that data is to be trarsterred from a 

CLDDR 

00184 

DO 

DASD device to a magnetic tape device. 

CLDDR 

00187 

COPY 

specifies that data is to be ccpied from one 

CLDDR 

00189 

CO 

device to another device of the sane type (that 

CLDDR 

00190 


is, from tape to tape or froa disk to disk). 

CLDDR 

"0193 

RESTORE 

specifies that data previously placed on magnetic 

CLDDR 

"0195 

RE 

tape by the DDE DUMP function is tc be restored to 

CLDDR 

00196 


a DASD device. 

CLDDR 

00198 

cyll 

specifies the first cylinder to be dumped, copied. 

CLDDR 

00199 


or restored. 

CLDDR 

00202 

TO 

i3 an optional reserved keyword. 

CLDDR 

00204 

T 


CLDDR 

00206 

cy 12 

specifies the last cylinder upon which the 

CLDDR 

00208 


specified operation is performed. If cyl2 is net 

CLDDR 

00208 


specified, only the cylinder specified in cyll 

CLDDR 

"0209 


will be operated upon. 

CLDDR 

00213 

REORDER 

is an optional reserved keyword used cnly if 

CLDDR 

00217 

R 

cyl3 is to be specified. This indicates that when 
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CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 


CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 


00218 

00218 

00220 


the tape is restored, the data Mill be placed cn 
the disk at a different cylinder than the one cn 
which if originally resided. 

00222 

00224 

cyl3 

specifies the cylinder at which reordering is to 
begin. If not specified, the default is c>11. 

00226 

00227 

00220 

00228 

00229 

00231 

00231 

00232 

CPVOL 

specifies that cylinder 0 and all allocated 

directory, and permanent disk sjace are to be 
copied, dumped, or restored. This indicates that 
the disk is in CP format, that is, it must have 
been formatted by the CP FORMAT/AILOCATE program. 
Refer to the I£iJ Vitiial flasAiflf jacj 

Operator*s Guide (Order No. GC2C-18C6) for an 
explanation of this program. . 

00235 

00237 

AJfl 

AL 

specifies that the operation is to be performed on 
all cylinders. 

00240 

00241 

PRINT or TYPE statement - produces a hexadecimal and EECC1C 
translation of each record specified. 

00244 

00245 

00246 

00247 

00248 

00249 

00250 



| | cc 1 [ hh 1 [rrlj] [TO cc2 [ hh2 £rr2jj] | 

1 PRINTITYPE 1 J2 Q 1 

| PR TY | | 

1 1 1 

1 i f 



00254 

00256 

PRINT 

PR 

specifies that output is to be directed to the 
SYSPRINT device. 

00258 

00260 

TYPE 

TY 

specifies that the output is to be directed to the 
console. 

00262 

00263 

cel 

specifies the cylinder at which printing cr typing 
is to begin. 

00265 

00267 

hhl 

specifies the track at which printing cr typing is 
to begin. If omitted, a value of zero is assumed. 

00269 

00270 

00271 

rrl 

specifies the ID of the record at which printing 
or typing is to begin. If omitted, heme address, 
record zero is assumed. 

00274 

00276 

00277 

00277 

00278 

TO 

T 

is a keyword which delimits the starting and 
ending address. If not specified, only one 

cylinder, track, or record will be printed or 
typed depending upon the specification cf starting 
address. 

00280 

cc2 

specifies the last cylinder to be printed cr 
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CLODS 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 


CLDDR 


CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 

CLDDR 


00281 


typed. If the 

00282 


specified. 

00284 

hh 2 

specifies the 

00285 


typed. If not 

00286 


track on cc2. 

00288 

rr2 

specifies the 

00289 


or typed. If 

00290 


entire track. 


keyword TO is specified, cc5 suet be 


last track of cc2 tc be printed or 
specified, the default if the laft 


last record ID of hh2 to be printed 
not specified, the default is the 


00294 Responses 


00296 DHSDDR711B YOLID IS volsel NOT volse2 

00298 DO YOU WISH TO CONTINUE? RESPOND YES NO OR REREAE: 


00300 

00301 

volsel 

is the voluae 
the DASD unit. 

00303 

00304 

volse2 

is the voluae 
output card. 

00307 

00308 

The voluae serial nuaber 
saae as that specified oi 


;erial nuaber from the veil label eh 

serial nuaber froi the input or 

read fros the device at ecu is not 
the INPUT or OUTPUT card. 


00310 DHKDDR716R NO VOL1 LABEL FOUND FOR umx 

00312 DO YOU NISH TO CONTINUE? RESPOND YES NO OR REREAD: 


00315 xxxxxx is the voluee serial nuaber of the EASE device 
00316 froa the input or the output card. 

00319 The DASD device at ecu contains no vclune serial nuaber. 


00321 DMKDDR717R DATA DUMPED FROM voll TO BE HESTOEED TC vcl2 

00323 DO YOU WISH TO CONTINUE? RESPOND YES NO OR REBEAE: 


00326 

00327 

00330 

00331 

00333 

00334 


roll is the voluae serial nuaber froa the input tape 

header record (voluae duaped). 

vol2 is the voluae serial nuaber froa the output DASD 

device. 

This aessage is printed for verification of the input 
paraaeters. 


00336 ENTER CYLINDER EXTENTS 

00338 ENTER: 


00339 This aessage is received only if the user if entering input 
00340 froa the console. 

00342 END OF CYL XXX HD XX, MOUNT NEXT TAPE 
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CLDDR 

00344 

RESTORING xxxxxx 




CLDDR 

00347 

xxxxxx is the voluae serial nuaber 

of the disk duaped. 

CLDDR 

00350 

The RESTORE operation has begun. 




CLDDR 

00352 

COPYING xxxxxx 




CLDDR 

CLDDR 

00354 

00355 

xxxxxx is the voluae serial nuaber 

unit. 

described 

by the 

input 

CLDDR 

00358 

The COPY operation has begun. 




CLDDR 

00360 

DUMPING xxxxxx 




CLDDR 

CLDDR 

00362 

00363 

xxxxxx is the voluae serial nuaber 

unit. 

descrited 

by the 

input 

CLDDR 

00366 

The duaping operation has begun. 




CLDDR 

00368 

PRINTING xxxxxx 




CLDDR 

CLDDR 

00371 

00372 

xxxxxx is the voluae serial nuaber 

unit. 

described 

by the 

input 

CLDDR 

00375 

The PRINT operation has begun. 




CLDDR 

00377 

END OF DUMP 




CLDDR 

00379 

The DUMP has ended. 




CLDDR 

00381 

END OF RESTORE 




CLDDR 

00383 

The RESTORE operation has ended. 




CLDDR 

00385 

END OF COPY 




CLDDR 

00387 

The COPY operation has ended. 




CLDDR 

00389 

END OF PRINT 




CLDDR 

00391 

The PRINT operation has ended. 




CLDDR 

00393 

END OF JOB 




CLDDR 

00395 

All specified operations have coapleted. 



CLDDR 

00397 

ENTER: 




CLDEBUG 

00001 

proapts the user to enter input. 
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CLDEBUG 00005 £S2JSS 


CLDEBUG 00007 
CLDEBUG 00008 
CLDEBUG 00010 
CLDEBUG 00011 
CLDEBUG 00011 
CLDEBUG 00012 
CLDEBUG D0013 
CLDEBUG 00014 


The DEBUG coaaand provides the user with orline facilities 
for debugging prograas and provides an entry in CMS fcr 
handling external interrupts, prograa interrupts, and 
unrecoverable errors. The subcoaaands which aay fce issued in 
the DEBUG environaent allow the user to exaaine and change 
the contents of certain control words and registers as well 
as portions of his virtual storage. The facilities of DEBUG 
are aade available to the user when: 


CLDEBUG 00018 
CLDEBUG 00020 
CLDEBUG 00022 
CLDEBUG O0C23 


• the DEBUG coaaand is issued 

• an external interrupt occurs 

• a break point is encountered during pregraa execution 
which causes a prograa interrupt 


CLDEBUG 00026 
CLDEBUG 00026 
CLDEBUG 00027 
CLDEBUG 00028 


Once DEBUG has been entered due to any of the above 
circuastance3, the user is said to be in the DEBUG 
environaent. The only valid input in this environaent is the 
group of DEBUG subcoaaands. 


CLDEBUG 00029 
CLDEBUG 00030 
CLDEBUG 00030 
CLDEBUG 00031 
CLDEBUG 00032 
CLDEBUG .00033 
CLDEBUG 00034 
CLDEBUG 00035 
CLDEBUG 00036 


When the DEBUG environaent is entered, the contents of all 
general registers, the channel status word, and the channel 
address word are saved so they aay be exaained and changed 
before being restored when leaving the DEEUG ervixenaent. 
If DEBUG is entered via an interrupt, the old pzograa status 
word for that interrupt is also saved. If DEEUG is the first 
coaaand entered after an ABEND occurs, the contents of all 
general registers, the CSV, the CAU, and the cld P5H are 
-available froa the tiae of the ABEND. 


CLDEBUG 00047 
CLDEBUG 00048 
CLDEBUG 0^049 


r 1 -- - 

] DEBUG | 

i. .. 




I 


CLDEBUG 00053 
CLDEBUG 00055 
CLDEBUG 00056 
CLDEBUG 00059 


£££2S SU BCO M MAND S: For a coaplete descripticn cf the DEBUG 
subcoaaands refer to lifl Machine » 

Progr aaaec^ G uid e t 2 Debuggi ng (Order No. GC2C-1807). The 
foraats are provided here for reference only. 


CLDEBUG 00062 ,---, 

CLDEBUG 00063 | BREAK | ( syabol } | 

CLDEBUG 00064 | BR J id ( } | 

CLDEBUG 00065 | | ( hexloc } J 

CLDEBUG 00066 «- J 


CLDEBUG 00069 Stop prograa execution at specified break point. 
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CLDEBOG 

CLDEBOG 

r T nPRT! Q 

00072 

00073 

00074 

00076 

i CAW | 

] 

.. 1 

v* L1/ u 'Hi 

CLDEBUG 

Type Channel Address Word contents at 

tine C E BUG was 

CLDEBOG 

00077 

entered. 



CLDEBUG 00079 
CLDEBOG 00C83 
CLDEBOG 00081 
CLDEBOG 00083 
CLDEBOG 00084 


r - —-- 

| CSV I 

I......-___-...-.... 

Type contents of Channel Status Word at 
entered. 


tine EE BOG 


I 

Mas 


CLDEBOG 00086 
CLDEBOG 00087 
CLDEBOG 00088 
CLDEBOG 00089 
CLDEBOG 00090 
CLDEBOG 00091 
CLDEBOG 00094 


{ DEFINE | *- 

| DEF | syabol hexloc j n | 

I I I 2 I 

I I 1 - J 

i. . - -- 

Assign a synbolic nane to a specific core adtress. 


T 

I 

I 

I 

I 

J 


CLDEBOG 00096 
CLDEBOG 00097 
CLDEBOG 00098 
CLDEBOG 00100 
CLDEBOG 00101 
CLDEBOG 00102 
CLDEBOG 00103 
CLDEBOG 00106 
CLDEBOG 00107 


i— 

} 1 s _ 

| DOBP || syabol 1 

I DU || hexloc 

1— “IT 

| syabol2 | | 

| hexloc2 | | 

ident 


1 1 1 

1 1 *~ 

■ 

1 *11 
i _ _j _j 


J 


Dunp the contents of specified portions of virtual storage 
to the virtual spooled printer. 


CLDEBOG 00109 
CLDEBOG 00110 
CLDEBOG 0^111 
CLDEBOG 00112 
CLDEBOG 00113 
CLDEBOG 00114 
CLDEBOG 00116 
CLDEBOG 00117 
CLDEBOG 00119 


»-;- - ---T 

111— —I I 
8 GO || syabol | | 
| j j hexloc j | 
I I *— — J I 

■ i------_____j 

Leave the DEBUG environaent and continue execution at the 
specified instruction or at the instruction indicated by the 
address portion of the PSW. 
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CLDEBOG 00122 „-- 1 

CLDEBOG 00123 | GPR | regl [reg2] t 

CLDEBOG 00124 * --- J 

CLDEBOG 00127 Type the contents of the specified general registers. 

CLDEBOG 00129 , --- 1 

CLDEBOG 00130 | HX J I 

CLDEBOG 00131 ‘--- 

CLDEBOG 00134 Return to CHS coaaand environment. 

CLDEBOG 00136 ,- 

CLDEBOG 00137 | ORIGIN| ( s/abol } J 

CLDEBOG 00138 J OB | { hexloc ) J 

CLDEBOG 00139 *- 

CLDEBOG 00141 Specify a base address to be added to locaticns specified in 

CLDEBOG 00142 other DEBOG subcoaaands. 

CLDEBOG DO 144 ,- 

CLDEBOG 00145 J PSU | | 

CLDEBOG 00146 '- 

CLDEBOG 00149 Type contents of the old Prograa Status Word. 

CLDEBOG 00151 ( ---, 

CLDEBOG 00152 | BET0RN| | 

CLDEBOG 00153 | BET j | 

CLDEBOG 00154 »-- J 

CLDEBOG 00157 Exit fron DEBUG environaent to CHS coaaand ervircnnent. 

CLDEBOG 00159 , -- 

CLDEBOG 00160 j SET j { CAN hexinfo } | 

CLDEBOG 00161 | j ( CSH hexinfo [hexinfo] } I 

CLDEBOG 00162 | | ( PSi hexinfo [hexinfo] } I 

CLDEBOG 00163 j | ( GPfi reg. hexinfo [hexinfo] } j 

CLDEBOG 00164 «---j 

CLDEBOG 00167 Change the contents of the specified location or register. 
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CLDEBUG 

CLDEBUG 

CLDEBUG 

CLDEBUG 

CLDEBUG 

CLDEBUG 


CLDEBUG 

CLDEBUG 

CLDEBUG 

CLDEBUG 

CLDEBUG 


CLDEBUG 

CLDEBUG 

CLDEBUG 

CLDEBUG 

CLDEBUG 

CLDEBUG 

CLDEBUG 


CLDEBUG 


CLDEBUG 

CLDEBUG 

CLDEBUG 

CLDEBUG 


CLDEBUG 


CLDEBUG 

CLDEBUG 

CLDEBUG 

CLDEBUG 

CLDEBUG 

CLDEBUG 

CLDEBUG 


00169 

y 1 ^ 

- ... ---- - -- 


00170 

| STORE | ( syabol 

) 

1 

00171 

1 ST |C 

} hexinfo 

1 

00172 

00173 

00176 

| | { hexloc 

». _ _ _ 

J 

1 

* 

Store inforaation 

in a specified virtual location. 



00178 

00179 

00180 

00181 

00184 


TIN I ( CMS ) 

! 8 C DBB J 

i__ 

Indicate leans of handling I/O 


n 


I 

5 


00186 ,-- 

00187 8 | —$ | 

00188 | X | { symbol } j n j | 

00189 8 f ( hexloc } J Jl | I 

00190 8 8 *- 4 I 

00191 »-J 


00194 Exaaine victual storage locations. 


00201 Note s: 


00205 1. The CBS coaaands HT and HO are not recognized in the 

00206 DEBUG environment. 


00209 2. The floating-point registers aay not be examined or 

00211 changed in the DEBUG environaent. 


00214 Responses : 


00222 

00223 

00224 

00225 

00226 

DNSD8G7 281 

DEBUG 

r 

1 

ENTERED <EXTERNAL INT 

{BREAKPOINT an AT 

L 

1 

1 

> 

hexlcc | 
j 

00231 

00233 

This specifies that the DEBUG environaent 
the reason stated. 

lias entered 
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CLDISK 00004 


CLDISK n 0007 The DISK command performs two functions: 


CLDISK 00011 1. 

CLDISK 00011 
CLDISK 00O12 
CLDISK 00013 


Punches disk files to the virtual spooled card punch in 
a special format which will allow the punched deck to 
be restored to disk in the fern of the original disk 
file. 


CLDISK 00015 
CLDISK 00016 
CLDISK 00017 


2. Hestores punched decks of a special fernat tc a disk 
file. These decks aust have been created fcy the DISK 
DUMP connand. 


CLDISK 00029 i- 

CLDISK 00030 | DISK | (DUMP fn ft [fl] J I 

CLDISK 00031 | 0 C J * 

CLDISK 00032 § j (LOAD } S 

CLDISK 00033 «-:- ■» 


’LDISK 00038 DOHP 
-LDISK 00039 
CLDISK 00039 
CLDISK 00040 
CLDISK 00040 
CLDISK 00041 
CLDISK 00042 


indicates that the specific file is to fe 
punched. The file say have either fixed cr 
variable—length records. After all data is 
punched, an end-of-file card is created with an 
N in coluan 5. This card contains directory 
information, and aust remain ic the deck. 7be 
original disk file is retained. 


CLDISK D0044 
CLDISK 00045 
CLDISK 00046 
CLDISK 00046 
CLDISK 00047 
CLDISK 00047 
CLDISK 00049 
CLDISK 00049 
CLDISK 00050 
CLDISK 00050 
CLDISK 00051 


LOAD 


specifies that one or aore card files are to te 
read froa the spooled card reader and written as 
CHS files on the user*s disk. The DISK LOAD 
operation reads a physical card reader deck 
consisting of any nuaber of logical decks 
previously punched by DISK DORP. File 
designations are obtained froa the card streaa. 
An existing file with the sane designation as 
one of those in the card streaa is erased and 
replaced. DISK LOAD loads files ento the 
priaary read/write disk. 


CLDISK 00053 
CLDISK 00054 


fn ft fa specifies the file identification: filename, 
filetype, and fileaode. 


CLDISK 00058 


Example 1 


CLDISK 00060 
CLDISK 00061 
CLDISK 00062 


c —— .... ■*■ 

| DISK | DUMP HYFILB 

« ... 


OLD At 



CLDISK 00066 
CLDISK 00066 
CLDISK 00067 


Acti on; The specified file, NYFILE OLD A1, is written to the 
virtual spooled punch. It is followed by an end-of-file 
card. 
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CLDISK 

00069 

Example 

2 





CLDISK 

00072 

p.__ 






CLDISK 

00073 

| DISK | 

| LOAD 


1 



CLDISK 

00074 

l_— 






CLDISK 

00078 

Assign: 

All files 

which were 

previcusly 

read 

into the 

CLDISK 

00078 

victual 

card reader 

are to be 

loaded onto 

disk; 

each file 

CLDISK 

00079 

aust be 

followed by 

an ead-of- 

file card as 

created by the 

CLDISK 

00081 

DISK DUMP function. 






CLDISK 

0008k 






CLDISK 

00086 

DISK SUMP gives no 

response except the READY 

aessage. 


CLDISK 

CLDISK 

CLEDIT 

00087 

00068 

00001 

DISK LOAD gives the file 
encountered in the input deck, 
after transfer is conpleted. 

identifier 
The READY 

fee each 

■essage is 

file 

typed 
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CLEDIT 

00003 

CLEDIT 

00006 

CLEDIT 

00010 

CLEDIT 

00012 

CLEDIT 

00014 

CLEDIT 

00015 

CLEDIT 

00016 

CLEDIT 

00017 

CLEDIT 

00020 

CLEDIT 

00022 

CLEDIT 

00024 

CLEDIT 

00026 

CLEDIT 

00027 

CLEDIT 

00028 

CLEDIT 

00031 

CLEDIT 

00033 

CLEDIT 

00034 

CLEDIT 

00036 

CLEDIT 

00037 

CLEDIT 

00047 

CLEDIT 

00048 

CLEDIT 

00049 

CLEDIT 

00050 

CLEDIT 

00057 

CLEDIT 

00058 

CLEDIT 

00058 

CLEDIT 

00059 

CLEDIT 

00059 

CLEDIT 

00060 

CLEDIT 

00061 

CLEDIT 

00062 

CLEDIT 

O0063 

CLEDIT 

00063 

CLEDIT 

00064 

CLEDIT 

00065 

CLEDIT 

00067 

CLEDIT 

00068 

CLEDIT. 

00069 

CLEDIT 

00069 

CLEDIT 

00070 

CLEDIT 

00070 


£212 


The EDITOB allows the CMS usee to: 

• Create, froa the terainal, sequential tiles consisting of 
either fixed or variable length records. 

• Provide, on the basis of certain known filetypes, 
automatic selection of record length, record format, 
logical tab settings, serialization, linenede, and 
lowercase to uppercase translation, 

® Add, delete, or change any part of a CMS file. 

• Extract all or part of a CMS file and make it a ten file, 
or embed it in another file. 

• Allow searching and changing of portions of the file 
through context-directed searches or by using a specific 
line number. 

• Receive automatic prompting with line numbers. 

• Allow any or all of the file to be typed out at the 
user's terminal. 

• Provide an interface to the CMS EXEC interpreter tc allow 
a 'macro' facility. 


| EDIT ) fn ft [fa] 
I S I 


[(LRECL nn)] ] 

! 


.j 


fn ft specify the filename and filetype of the file to 

be created or edited. If a file kith the 
specified filename and filetype does not exist, 
the CMS EDITOR assumes that the file is being 
created, and after the input environment is 
entered, information typed by the user becomes 
input to that file. If a file with the sane 
filename and filetype does etist, the EDIT 
environment is entered, enabling the user to 
issue EDIT subcommands and to modify the 
specified file. Both fn and ft must be 
specified. 

fn specifies the filemode of the file to be created 

or edited. If fm is specified, EDIT searches 
only the indicated disk. If fn is specified as 
an asterisk, EDIT searches all disks for the 
existence of that file. A blank specification 
for filenode causes searching of cnly the 
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CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 


CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 


CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 


00071 
00071 
00072 
00072 
00073 
0 0074 


priaary disk. If the file is found, its node is 
saved, EDIT later writes the altered file back 
to that saae disk. If an existing file is not 
found, the newly-created file is placed on the 
disk specified by fa or on the user’s priaary 
disk. 


00076 

00077 

00078 


LRBCL nn specifies the record length of the file to be 
created or edited. If uo record length is given, 
the following default values are assuied: 


00083 


Mil lag Bxjsiiag.fiigs 


00085 

00087 

00088 


F fora at: 

Existing record length is kept regardless 
of foraaf. 


00091 


Cr eati ng Hew_fil es 


00093 7 foraat: 

00095 Filetype LISTING: 121 


00098 

00100 

00103 

00104 

00105 

00105 

00106 

00107 


P foraat: 

All filetypes: 80 

If the record length derived in this way is 
saaller that that of the existinc file, then the 
EDITOR types out an error nessace, and aust be 
invoked again with an adequate reccrd length 
given* The aaxiaua record length suppcrtedi ty 
the editor is 133. 


00112 Mil Subcoaa ands 


00114 Refer to the i£l| Vitlaai g gchj ne Facjjj ty/ 37Q, f££T Guide 
00115 (Order No. GC20-1805) for a functional description of each 
00116 of the edit subcoaaands. The foraats are given here for 
00117 reference only. 


00129 

00130 

00131 

00132 

00133 

00134 

00135 


I ALTER | r i 1 

I AL f {charl} (char2) | n r j I 

I | Jhexl } (her2 } | * | G | | | 

I I 111*11 I 

I 1 i t j j , 

i — —.— - j 


00138 Scan the first ’n* records of the file altering the 
00139 specified character either once in each line cr for all 
00140 occurrences in the line. 
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CLEDIT 00143 
CLEDIT 00144 
CLEDIT 00145 
CLEDIT 00146 


| BOTTOM 
I B 

r 


l 

3 


l 

I 


_i 


CLEDIT 00150 


CLEDIT 00153 
CLEDIT 00154 
CLEDIT 00155 
CLEDIT 00156 
CLEDIT 00157 
CLEDIT 00158 

CLEDIT 00161 
CLEDIT 00162 


CLEDIT 00165 
CLEDIT 00166 
CLEDIT 00167 
CLEDIT 00168 
CLEDIT 00169 
CLEDIT 00170 
CLEDIT 00171 


Hake the last line of the file the current line. 


«"*.. 

I CASE 

1 

r 

1 


3 

1 

1 u 1 


1 

1 

1 M | 


1 

t__ 

1 

L 

J 



Indicate if translation to uppercase is tc tc done cc 
display current status. 


1 . 

| CHANGE | 

r 

r 

1 

1 1 j 

I c | 

/string1/string2 | / 

1 

« r i 1 3 1 

f 1 

8 

| 

1 1 G 1 1 1 1 

! 1 

! 

8 

*3*1113 

t 1 

k 

L 

o L J J J I 

*- 



. J 


CLEDIT 00175 
CLEDIT 00175 
CLEDIT 00178 


Change string! to string2 for *n* records or to EOF, either 
for the first occurrence in each line or for all 
occurrences. , 


CLEDIT 00181 
CLEDIT 00182 
CLEDIT 00183 
CLEDIT 00184 


I CHS | 

t 3 



CLEDIT 00189 Enter CHS subset connand node 


CLEDIT 

CLEDIT 

00192 

00193 

i ■" ■ 

f DELETE 

1 

r 

— 

i 

1 

CLEDIT 

00194 

| DEL 

3 

1 

n 

8 

3 

CLEDIT 

00195 

1 

1 

1 

.1 

i 

1 

CLEDIT 

00196 

I 

i 

3 

* 

3 

3 

CLEDIT 

00197 

1 


k 


j 

3 

CLEDIT 

00198 

»-.■ ■■■■ • 

_ 

r - - 



j 


CLEDIT 00202 Delete *n 9 lines or to the end of the file (*). 
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CLEDIT 

00205 

CLEDIT 

00206 

CLEDIT 

00207 

CLEDIT 

00208 

CLEDIT 

00209 

CLEDIT 

00210 

CLEDIT 

00214 


CLEDIT 

00217 

CLEDIT 

00218 

CLEDIT 

00219 

CLEDIT 

00220 

CLEDIT 

00223 

CLEDIT 

00224 


CLEDIT 

00227 

CLEDIT 

00228 

CLEDIT 

00229 

CLEDIT 

00230 

CLEDIT 

00234 


CLEDIT 

00237 

CLEDIT 

00238 

CLEDIT 

00239 

CLEDIT 

00240 

CLEDIT 

00244 


CLEDIT 

00247 

CLEDIT 

00248 

CLEDIT 

00249 

CLEDIT 

00250 

CLEDIT 

00254 


CLEDIT 

00257 

CLEDIT 

00258 

CLEDIT 

00259 

CLEDIT 

00260 

CLEDIT 

00261 

CLEDIT 

00262 

CLEDIT 

00265 

CLEDIT 

00266 


i - ---1 

I DOWN | r I 

ID I I n | I 

I lili i 

I I *- J i 

i_____ J 


Point to the n'th line froa the current line. 


TfILE | £f n £f t [fa ]]] 1 

I 8 I 

i_ . . - . ■ - - ■ ■- ■-1 


Save the file being edited on disk ci change its 
identifiers. Beturn to CMS. 


«- -—- - T> 

{FIND | line | 

II I 

«___—___-_ j 


Search the file for the given line. 


«- 

| FHODE 

1 

r . 

1 ££■] 

1 

Beset or 

display the fileaode. 

i FNAHB 
« 

8_ 

1 [fn] 

8 


Beset or display the filenaae. 



■i 


.j 


| GETFILE | 

1 GE j 

r 

fn | 

ft 

r 

1 

fa 

r r i i "i.l 

8 a | n | | | | | 

1 1 

1 

* 

i 

* 

111*11111 

8 9 

i—.__ 

L 


8. 


L L J J J J J 

J 


Insert soae or all of the given file folic King the current 
line* 
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CLEDIT 

00269 

CLBDIT 

00270 

CLEDIT 

00271 

CLEDIT 

00272 

CLEDIT 

00273 

CLEDIT 

00274 

CLBDIT 

00275 

CLEDIT 

00279 


CLEDIT 

00282 

CLEDIT 

00283 

CLEDIT 

00284 

CLEDIT 

00285 

CLEDIT 

00289 


CLEDIT 

00292 

CLEDIT 

00293 

CLEDIT 

00294 

CLEDIT 

00295 

CLEDIT 

00296 

CLEDIT 

00297 

CLEDIT 

00298 

CLEDIT 

00302 


CLEDIT 

00307 

CLEDIT 

00308 

CLEDIT 

00309 

CLEDIT 

00310 

CLEDIT 

00314 


CLEDIT 

00317 

CLEDIT 

00318 

CLEDIT 

00319 

CLEDIT 

00320 

CLEDIT 

00324 


CLEDIT 

"0327 

CLEDIT 

00328 

CLEDIT 

00329 

CLEDIT 

00330 

CLEDIT • 

00331 

CLEDIT 

00332 

CLEDIT 

00336 


i- 

| IMAGE 

1 

1 

r 

1 

ON 

1 



1 

1 

OFF 

1 



1 

3 

CANON 

3 



1 

t. 


j 



Expand text into line inages or display current setting 


i.. .- .<— -1 

| INPOT | [line] j 

3 11 3 

i ____—--- j 


Insert 'line' in the £ile or enter INPUT aode. 


i — — - 

1 1 

r i 

I LINEMODE | 

|LEFT | 

| LIME | 

(BIGHT! 

9 3 

|OFF | 

1 1 
•- 

i J 


Set or display current line setting. 


j LOCATE 

1 L 

0 

1 /string [/] 

3 

T 

1 

1 

scan file 

fron next line for first 

occurence of 'string 

j LONG 

1 

■ 

1 

-- 1 

1 

! 

1 

.... j 


Enter LONG error nessage node. 


I NEXT I r -o 3 

IN tins 3 

I 3 3 1 9 I 

I 3 *• J I 

i---—- j 


Point to the n'th line fron current line. 


10 4 








IBM CONFIDENTIAL 


CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 


CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 


CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 


CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 


CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 


CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 


00339 , -t 

00340 I OVERLAY J line J 

00341 J 0 | I 

00342 '-J 


00346 Replace all or pact of the current line. 


00349 ,--- 

00350 | PRESERVE! I 

00351 | PRE | I 

00352 t—------» 


00356 Save current node settings. 


00359 ,-- 

C0360 | PROMPT ! [ incr ] | 

00361 | | | 

00362 ‘-— 


00365 Set or display line nunber increaent. Initial setting is 
00366 10. 


00370 

00371 

00372 

00373 

00377 


00380 

00381 

00382 

00383 

00384 

00385 

00389 


00392 

00393 

00394 

00395 

00396 

00397 

00398 


I QUIT ! ] 

I I i 

«... .......... j 


Terminate EDIT session with no updates since last *SAVE* 


i - - - - - ■ - - 1 


« 1 r i 

| 8ECFORH | | F | 

| REC 1 1 V | 

1 1 *■ J 

1 

1 

1 

i 

> - - . - _ 


Set or display record foraat 

for subsequent files. 

t REPEAT | r i 

I 1 I n | 

! Mil 

! i 1 * 1 

j 5 i. J 

i 

1 

1 

! 

! 

I 

l _ 



00402 Execute the following OVERLAY subconnand n tines. 
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CLEDIT 
CLEDIT 
CLEDIT 
CLEDIT 

CLEDIT 

CLBDIT 


CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 


CLEDIT 
CLEDIT 
CLEDIT 
CLEDIT 

CLEDIT 


CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 


CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 


CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLBDIT 

CLEDIT. 

CLEDIT 

CLEDIT 


00405 ,-- 

00406 | REPLACE | [line] 1 

00407 | R | I 

00408 «-- J 


00411 Replace the current line uith line or replace the current 
00412 line and enter INPUT node. 


00415 j---T 

00416 | RESTORE | I 

00417 | RES | I 

00418 *- J 


00422 Restore aode settings to values last preserved. 


00425 

00426 

00427 

00428 


*---T 

| RETURN | 1 

I I I 

«- .- ______....__ J 


00432 Return to EDIT environment fron CHS subset. 


C 0 4 3 4 
00435 
00436 
00437 
00438 


I Sr i 

| REUSE | | edit subconaand | 

I_ i L J 


I 

I 

I 

.j 


00443 Stack (LIFO) the last edit subconaand not starting with 
00444 REUSE or 7 and then execute any given edit subconaand. 


00448 ,--j 

00449 1 SAVE j [fn [ft [£■]]] J 

00450 II I 

00451 »-J 


00455 Save the file on disk and stay in EDIT envircnnent. 


00458 

00459 

O0460 

00461 

00462 

00463 

00464 


| SERIAL 

1 8 


OFF 



9 

| SER 

1 8 




r i 

9 

1 

1 8 

8 

seg 

9 

liner| 

9 

1 

1 8 

8 

ON 

9 

1 12 ( 

9 

1 

1 8 

8 

ALL 

9 

L 1 

9 


00470 Turn serialization on or off in columns 73-8C. 
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CLEDIT 

00473 

CLEDIT 

00474 

CLEDIT 

00475 

CLEDIT 

00476 

CLEDIT 

00480 


CLEDIT 

00483 

CLEDIT 

00484 

CLEDIT 

00485 

CLEDIT 

00486 

CLEDIT 

00487 

CLEDIT 

00488 

CLEDIT 

00489 

CLEDIT 

00493 

CLEDIT 

00494 


CLEDIT 

00497 

CLEDIT 

00498 

CLEDIT 

00499 

CLEDIT 

00500 

CLEDIT 

00504 


CLEDIT 

00507 

CLEDIT 

00508 

CLEDIT 

00509 

CLEDIT 

00510 

CLEDIT 

00511 

CLEDIT 

00512 

CLEDIT 

00515 

CLEDIT 

00516 


CLEDIT 

00518 

CLEDIT 

00519 

CLEDIT 

00520 

CLEDIT 

00521 

CLEDIT 

00522 

CLEDIT 

00523 

CLEDIT 

00524 

CLEDIT 

00525 

CLEDIT 

00529 

CLEDIT 

00530 


j SHORT | 

1 f 



1 

1 

1 

Enter SHORT 

error 

aessage aode. 


j STACK | 

r 


1 

\ 1 

1 

n 1 

1 

1 1 

1 

1 1 

1 

i 1 

jedit 

subcoaaand| 

J 

1 i 

L 

j 

1 


. 

. . . . . —.- 



Stack 'a* lines,, beginning with current lice, in terainal 
input buffer. 


i- - -T 

| TABSET J tabs.. • | 

| TABS i I 

i......-....—- j 


Set the given tabs. 


I I r i 

I TBUNC | J n j 

I 11*1 

I I . «■ * 


i 

I 

I 

I 

I 


Set or display the coluan of truncation. * leans end of 
logical record. 


i --— 

1 r 

t f 

a 

r 

! 


T 

•t i 

i I 

| TYPE 

3 1 

1 

1 

n 

1 1 

1 T 

1 1 

— 

1 

* 

i 1 


i I 

* 

1 


i 1 

i__ 

t «■ 


L 


J i 


Type 'a* lines beginning with either the current line, the 
nth line, or the beginning of the file. 



107 





IBM CONFIDENTIAL 


» 

CLEDIT 00533 <- 

CLEDIT 00534 J TOP | 

CLEDIT 00535 | j 

CLEDIT 00536 »-- 



CLEDIT 00540 


Point to the beginning of the file. 


CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 


00542 

00543 

i — 

1 

1 r i 

1 

00544 

I (IP 

1 in] 

1 

00545 

t o 

1 111 

1 

00546 

1 

i »■ J 

1 

00547 

i 


— J 


CLEDIT 00551 


Point to the line J n“ lines above the current cne. 


CLEDIT 00554 *--t 

CLEDIT 00555 | I r t r i I 

CLEDIT 00556 j VERIFY j | ON J | n j | 

CLEDIT 00557 | V J |OFF| |* | J 

CLEDIT 00558 | | i. j «. j | 

CLEDIT 00559 •.. .. .J 


CLEDIT 00562 
CLEDIT 00563 


Set, display, or reset verify node. * leans end of logical 
record. 


CLEDIT 

CLEDIT 

00565 

00566 

i— — 

1 r 

1 

. 1 

CLEDIT 

00567 

1 x 

I | edit subcoinand 

1 


CLEDIT 

00568 

1 Y 

1 1 n 

1 


CLEDIT 

00569 

1 

I I 1 

1 


CLEDIT 

00570 


| L 

J 


CLEDIT 

00571 




- 


CLEDIT 00574 
CLEDIT 00576 


Assign to I or I the given edit subccuand or execute the 
previously assigned subcoaiand n tines. 


CLEDIT 

00579 

i-- 

1 

1 ' r 


r 


■j ■» 

1 

CLEDIT 

00580 

S ZONE 

i 8 

a 

i 

i 

a 

1 1 


CLEDIT 

00581 

« z 

I 1 

1 


1 1 


CLEDIT 

CLEDIT 

CLEDIT 

00582 

00583 

00584 

1 

1 

i___... 

S I 

J «. 


i 

L 

# 

1 1 

4 J 



CLEDIT 00587 
CLEDIT . 00588 


Set or display the coluins between which editing is to taks 
place. 
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CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

00592 

00593 

00594 

00595 

00596 

t — i 

II 1 

1 7 1 1 

1 1 1 

8__ _ J 


CLEDIT 

CLEDIT 

00599 

00600 

Type out the last edit subcoaaand which did cct begin with 
REtJSE or ? 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

00602 

00603 

00604 

00605 

00606 

i- —» 

1 1 r i 1 

| nnnnn | | text | 1 

\ \ *■ J 1 

a_ - --- .- .-_ _j 


CLEDIT 

CLEDIT 

00609 

00611 

Locate the line specified by the given line 
insert text if given. 

nuaber and 

CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

00617 

00618 

00619 

00620 

r— — ~ i 

I Sdop 1 n J 

1 i 1 

U J 


CLEDIT 

00622 

Duplicate the current line n tines. 


CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

00624 

00625 

00626 

00627 

i-—- —i 

1 SHOVE 1 a {UP ) n 1 

1 1 {DOUMJ | 

«- - 1 


CLEDIT 

00629 

Hove a lines up or down n lines. 


CLEDIT 

00636 

Responses 


CLEDIT 

00638 

NEW FILE: 


CLEDIT 

00640 

The specified file does not exist. 


CLEDIT 

00642 

EDIT: 


CLEDIT 

CLEDIT 

CLEDIT 

00643 

00644 

00646 

The EDIT environeant is entered. The logical tab settings 
aay be either those defined by the user oi those assuied 
fron the filetype. An EDIT subcoaaand aay now be issued. 


1C 9 


IBM CONFIDENTIAL 


CLEDIT 

00649 

INPOT: 




CLEDIT 

CLEDIT 

CLEDIT 

CLEDIT 

00650 

00652 

00652 

00653 

The Input 
subcoaaands 
subsequent 
file. 

environaent 
REPLACE or 
input lines 

is entered by issuing the 
INPUT with no paraaeters. 
will be accepted as input tc 

EDIT 

All 

the 

CLEDIT 

00655 

?EDIT: line 




CLEDIT 

CLEDIT 

CLEDIT 

00656 

00657 

00659 

"line" has been entered 
invalid EDIT subcoaaand 
nessage appears while in 

in the EDIT envirocaent and 
or EDIT aacrc subcoaaand. 
LONG error aessage aode. 

xs an 
This 

CLEDIT 

00662 

-% 




CLEDIT 

CLEDIT 

00663 

00665 

An invalid 
environaent 

subcoaaand has been entered in the 

while in SHORT error aessage aodc. 

EDIT 

CLEDIT 

00667 

-»$ 




CLBDIT 

CLEBASE 

00669 

00001 

An invalid EDIT aacro subcoaaand has been entered while in 
SHORT error aessage node. 
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CLBRASE 


CLERASE 

CLERASE 

CLERASE 

CLERASE 

CLERASE 

CLERASE 

CLERASE 

CLERASE 

CLERASE 

CLERASE 

CLERASE 

CLERASE 

CLERASE 

CLERASE 

CLERASE 

CLERASE 

CLERASE 

CLERASE 

CLERASE 

CLERASE 

CLERASE 

CLERASE 


CLERASE 


CLERASE 

CLERASE 

CLERASE 

CLERASE 


CLERASE 

CLERASE 

CLERASE 


CLERASE 

CLERASE 

CLERASE 

CLERASE 

CLERASE 

CLERASE 


00005 

£Ri5E 


00007 

00008 

00009 

The ERASE coaaand deletes a file or a related group of files 
froa a user's read/write disk. The file to he deleted aust 
not be on a read/only disk. 

00020 

O0021 

00022 

00023 

00024 

00025 



V 

i 

| ERASE 
1 

1 

A .- - - 

1 r t 1 

j fn ft [fa] | (TYPE) | 9 

I i f NOTYPE) i i 

1 L J 9 

-... ..- -.- - J 



00030 

00031 

00031 

00032 

00033 

f n 

specifies the filenane of the . files to be erased. 
An asterisk aay be coded in this position to 
indicate that all fiienanes are to be esed. This 
field aust be specified, either with a naae or an 
asterisk. 

00035 

00036 

00036 

00037 

00038 

ft 

specifies the filetype of the files ic be erased. 
An asterisk aay be coded in this position to 
indicate that all filetypes are tc be used. This 
field aust be specified, either with a naae or an 
asterisk. 

00040 

00041 

00042 

fa 

specifies the fileaode of the files tc be erased. 
If this field is oaitted, the priiary read/write 
disk is searched for the files to be erased. 

00045 

OfitifiJlS 


00048 

00050 

TYPE 

T 

indicates that the file identifier for each file 
erased is to be typed at the terainal. 

00054 

00058 

jlOHSf 

N 

file identifiers are not to be typed at the 

terainal. 

00060 

00061 

00063 

Note: If asterisk is specified for filenaie and filetype 
then fileaode aust be specified. The fileacde aust include 
both a aode letter and nuaber. 

00065 

00067 

00068 

O0«69 

00072 

00073 

Ezaaple 


| ERASE 

a . 

| OLDFILE TEMP (TYPE) ] 

&U22: 

located 

The file with the identifier OLCFIIE TEMP, it 
on the priaary read/write disk, is erased. Its file 
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CLEBASE 

00075 

identifier 

is typed at the terainal. 

CLKBASE 

00080 

IfiSBgflS&s 


CLEBASE 

00082 

fn ft 

fa 

CLERASE 

00083 

If the TYPE 

option has been specified, the filcid for each 

CLBXEC1 

00001 

file erased 

is typed. 
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CLBXEC1 

00005 

CLEXEC1 

00008 

CL EXEC 1 

00008 

CLEXEC1 

00009 

CL EX EC 1 

00010 

CLEXEC1 

00011 

CLEX EC 1 

00013 

CLEX SCI 

00022 

CLEXEC1 

00023 

CLEXBC1 

00024 

CLEXEC1 

00025 

CLEXBC1 

00032 

CL EX EC 1 

00032 

CLEXEC1 

00033 

CLEXBC1 

00034 

CLEXEC1 

00034 

CL EXEC 1 

00035 

CLEXBC1 

00036 

CLEXEC1 

00037 

CLEXEC 1 

00039 

CLEXEC1 

00042 

CLEXEC 1 

00042 

CL EX EC 1 

00043 

CLEXBC1 

0004 4 

CLEXEC1 

00044 

CLEXEC1 

00045 

CLEXEC1 

00046 

C L EX EC 1 

00047 

CLEXEC1 

00047 

CLEXEC1 

00049 

CLEXEC1 

00050 

CLEXEC1 

00050 

CLEXBC1 

00051 

CLEXEC1 

00052 

CL EX EC 1 

00053 

CLEXEC 1 

00054 

CLEXEC1 

00054 

CL EX EC 1 

00055 

CLEXBC1 

00055 

CLEXEC1 

00055 

CLEXEC 1 

00056 

CLEXEC 1 

00057 


£ 2 ££ 


The EXEC command executes one or more CHS ccaaands or EXfcC 
control comaands contained in a specified file, allowing a 
sequence of commands to be executed by issuing a single 
coaaand. If this coaaand is entered fron the CHS conaand 
node but not nested within another EXEC procedure, the 
initial word 'EXEC* nay be oaitted. 


| EXEC | fn [args... ] I 

I EX | | 

. .. -— - j 

fn specifies the filenaae » of a file cctfaining one cr 

sore CHS conaands to be executed. The filetype cf 
the file nust be EXEC and the file ausf be fixed 
fornat with a logical record length not exceeding 
130 characters. EXEC files can be created with the 
EDIT coaaand or by a user's progran. EXEC riles 
created by the CHS EDITOR have a logical record 
length of 80 characters. Each EXEC file nay contain 
a aaxiaun of 4096 lines. 

args specify the arguaents to replace the nuaeric 
variables in the EXEC file specified. Within an 
EXEC file, up to thirty synbolic variables aay te 
used (each one indicated by an anpetsand ( 6 ) 

followed by an integer ranging fron one to thirty) 
to indicate values which are tc be replaced when the 
EXEC file is executed. The arguments are assigned 
to synbolic variables in the order in which they 
appear in the argument list. For exanple, each tixe 
an SI appears in an EXEC line, the first arguaent 
specified with the EXEC coaaand temporarily replaces 
the &1, the second argument specified with the EXEC 
coaaand replaces &2, and so on, to argument N of the 
EXEC coaaand. 

If the double quotation nark ( N ) is used in place cf 
an arquaeni, the corresponding variable (£N) is 
ignored in all the conaands which refer to that 
variable. If the specified EXEC file contains more 
variables than arguaents given with the EXEC 
coaaand, the higher numbered variables are assuaed 
to be nissing, and are ignored when the ccnnands are 
executed. 
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CLEXEC1 00061 £X££ PILES 


JLEXECI 00063 EXEC files consist of two types of statements; 

CLEXEC1 00066 1, nonexecutable - begins with an asterisk (*) and nay cr 
CLEXEC1 00067 nay not contain text. These statements are intended 
CLEXEC1 00068 for use as comment statements and are ignored during 
CL EX EC 1 00069 execution. 

CLEXEC1 00071 2. executable - does not begin with an asterisk. These 
CLEXEC1 00072 statenents consist of sequences cf strings cf 
CLEXEC1 00074 contiguous non-blank characters separated by blanks. 


CLEXEC1 00078 Inte r pretation o£ Execg t able St a tements 


CLEXEC1 00079 Executable statenents are interpreted, one at a tine, 
CLEXEC1 00081 according to the following steps, 

00084 1, Except for those connands that take a 'line' (an 

00085 arbitrary, unsubstituted, collection of words) as an 

00086 argument, the words forning a statenent are 

00087 ’tokenized*. That is, each word is treated as an eight 

00^87 character quantity and is padded kith blanks or 

00009 truncated, as necessary. 

CLEX EC 1 00091 2. 

CLEXEC1 00092 

CLEXEC1 00093 
CLEXEC1 00094 
CLEXEC1 00095 

CLEXEC1 00096 
CLEXEC1 00097 

CL EXEC 1 00102 a. Each token is scanned for anpersands, starting with 

CLEXEC 1 00104 the rightnost character of the token. 

CLEXEC1 00106 b. If an ampersand is found, then it, with the rest of 

CLEXEC1 00108 the token to the right, is taken as a name. Then: 

CLEXEC 1 00111 

CLEXEC1 00112 

CLEX EC 1 00113 

CLEXEC 1 00114 

CLEXEC1 00115 

CLEXBC1 00116 
CLEXEC1 00117 

CLEXEC 1 00122 (An EXEC keyword is a control werd, a built-in 

CLEXEC1 00123 function, or either of the Epecial tokens 84 and 

CLEXEC1 00124 6*.) The token so formed is padded with blanks. 
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IF . it is the name of an active variable, 

it is replaced (in the token) by its value; 

ELSE 

IF it is the name of an EXEC keyword, 
it is left unaltered; 

ELSE 

it is replaced (in the token) by blanks. 


The tokens are searched for the names of any EXEC 
variable, which are replaced by their values. There is 
an exception if the token is the target of an 
assignment; in this case the nane of the variable is 
retained. Tokens forning a statement are searched fee 
the nanes of EXEC variables, which are replaced by 
their values as follows. 


CLEXEC 1 
CLEXBC1 
CLEXEC1 
CL EXEC 1 
CLEXEC1 
CLEXEC1 




CLEXEC1 

CIEXEC1 

CLEXEC1 
CLEXEC1 
CLEXEC 1 
CLEXEC1 
CLEXEC1 
CLEXEC1 
CL EXEC 1 

CLEXEC1 
CLEXEC1 
CL EXEC 1 
CLEXEC1 

CLEXEC 1 
CLEXEC1 
CLBXECl 

CLEXEC1 
CLEXEC1 

CLEXEC1 

CLEXEC1 

CLEXEC 1. 

CLBXECl 

CLEXEC 1 
CLEXEC1 
C LEXEC1 
CLEXEC1 
CLEXEC1 
CLEXEC1 
CLEXEC1 
CLEXEC1 

CL EX EC 1 

CLEXEC1 


CLEXECt 
CLEXEC1 
CLEXEC 1 

CLEXEC1 




IBB CO 

NPIDENTIAL 

00124 

or truncated, as 

necessary, to maintain 

00125 

of eight. 


00129 

c. Scanning resumes at 

the next character tc t 

00130 

and the procedure 

is repeated frees (fc) 

00131 

until the 

token 

is exhausted. There 

00131 

exception 

if the 

token is the target 

00132 

assignment; 

in th 

is case scanning for ax 

00132 

effectively 

stops 

on the second character 

00133 

token. 




a length 


he left, 
above, 
is an 
of an 
persands 
of the 


00135 Note that any characters which are substituted are not 

00136 scanned for ampersand. They are, however, included in 


00136 

00137 

the next name if another 
left. 

ampersand 

is 

found to 

the 

00138 

This processing makes 

it 

possible 

tc 

simulate 

the 

00140 

effects of subscripted 

variables. 

For 

e sample. 

the 


00141 sequence: 

00143 6X = 123 

00145 STIPE ABC SX ABCSX 000000SX' 


00147 yields the printed line: 

00149 ABC 123 ABC123 00000012 


O0151 The sequence: 


00153 

entered 


a£tS£ SUfeStilllliSJl 

00154 

61 * 2 



00157 

• • • 



00158 

6X61 = 5 


6X2 = 5 

CO 159 

61 ■ 61 - 

1 

61 = 1 

00160 

6X61 * 61 

+ 1 

6X1 = 2 

00161 

• • e 



00162 

6X = 6X61 

♦ 6X6X61 

6X = 6X1 ♦ £X2 or £X 


00163 STIPE ANSWER IS SX 

00165 yields the printed line: 

00167 ANSWER IS 7 


00174 3. I£ at this point the token is entirely tlank, it is 
00175 discarded fron the statement, so that the next tcken is 
00177 deened to innediately follow the previous one. 

00180 4, The statenent is analyzed syntactically, and executed. 
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CLEXECI 


CLEXEC1 
CLEXEC1 
CLEXEC1 

CLEXEC 1 

CL EX SCI 
CLEXECI 

CLEXECI 

CLEXECI 
CLEXEC1 
CLEXEC 1 
CLEXECU 
CLEXEC1 
CL EX ECU 

CLEXEC1 

CLEXBCt 
CL EX EC 1 
CLEXEC1 
CLEXEC1 
CLEXEC 1 
CLEXKC1 

CLEXEC1 

CLEXEC1 
CLEX EC1 
CLEXEC1 
CLEXEC 1 

CLEXEC1 

CLEXECI 

CLEXECI 

CLEXeCI 
CLEXSC1 
CLEXECI 
CLEXECt 

CLEXRC 1 
CLEXECI 
CLEXECI 

CLEXECI 

CLEXECI 

CLEXECI 


00185 ness 2i staisiaats: 


00186 There ace four classes o£ executable statements: 1) null 
00187 statements, 2) CMS commands, 3) assignment statements, and 
00189 4) control statements. The four classes are described below. 


00192 

1. 

Null statements. 

00193 

00195 


A null statement is 
the number of tokens 

00198 

2. 

CMS commands. 


an executable statement in which 
is zero. 


00200 

00201 

00201 

00202 

00203 

00204 


An executable statement is a CMS command if the first 
token does not start with an ampersand or asterisx. It 
is executed immediately. Hhen execution is finished, 
control returns to the EXEC file, and the completion 
code from the CHS command is placed in the special EXEC 
variable 6BETCODE» 


00207 3, Assignment statements. 


00208 

00209 

00210 

00211 

00212 

00213 


An executable statement is an assignment statement if 
the first token starts with an ampersand and the second 
token is an equal sign. The first token is taken as the 
name of an EXEC variable, and is assigned the value cf 
the expression which follows the equal sign. The 
expression may be any of the following: 


00216 


a. A single token, such as ABC 


00219 

00220 

00220 

00222 


b. An arithmetic expression, consisting of a sequence 
of tokens which possess positive or negative 
integral values and are Separated by plus or minus 
signs, such as 3 - 4 * -11 - 00. 


00224 

00225 


c. A built-in function followed by its arguments, such 
as &SUBSTB 61 2 1. 


00230 4. Control statements. 


00231 

00232 

00233 

00234 


An executable statement is a control statement if the 
first token is an EXEC control word and the second 
token is not an equal sign. Examples cf ccntrcl words 
are: 


00237 

00239 

00241 


6 GO TO 
6 EX IT 
&IF 


00243 Control statements begin with a control word, which is 
00244 usually followed by a list of tokens, acd in seme cases 
00245 by additional lines of data. The control werds, and 
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CLEXEC1 00246 


the rules for their use* are as fellows. 


CLEXEC1 00257 
CLEXEC1 00258 
CLEXEC1 00259 


t-_______ 

| SARGS | [argl [arg2 ... 

i_ 


J] ] 


j 


CLEXEC1 00264 
CLEXEC1 00264 
CLEXEC1 00265 
CLEXEC 1 00274 


Redefine the arguments SI, &2, ... with tie value cf 
'argl', 'arg2', ..., and reset the variable 6IKDEX to 
the nuober of arguments so set. The remaining 
arguments are set to blanks (see SREAD 1EGS). 


CLEXEC1 

00276 

r~ 

• 4 

CLEXEC1 

00277 

{ &BEGPUNCH. | 

[ALL] | 

CLEXEC1 

00278 

« 

---! 

CLEX EC 1 

00280 

linel 


CLEXEC1 

00282 

line2 


CLEXEC 1 

00284 

* • I 


CLEXEC1 

00286 

i — -- 

• 1 

CLEX EC1 

00287 

$ &END | 

1 

CLEXEC1 

00288 

t_ 

» 


CLEIECt 00291 
CLEXEC1 00292 
CLEXEC1 00292 
CL EX EC 1 0 0293 

CLEXEC1 00293 
CLEXEC1 00294 
CLBXEC1 O0296 


Punch 'linel*, *line2*, ... into the card-punch, 
without iokenizing then. The lines are normally 
truncated at column 72 and padded with blanks to fill 
an eighty-coluan card; truncation can be avcided by 
specifying the option *ALL'» The stateaent is 
ferainaied by a line in which the string * 6ENE * starts 
in coluan 1 (see &PUNCH). 


CLEXEC1 00298 
CLEXEC1 00299 
CLEXEC1 00300 
CLEXEC1 00301 
CLEXEC1 00302 
CL EXEC 1 00303 

CLEXEC1 00305 
CLEXEC1 00307 
CLEXEC1 00309 
CLEXEC1 00312 
CLEXEC1 00314 
CLEXEC1 00315 
CLEXEC1 00316 


I r i r i I 

&BEGSTACK J |£J£0| |1ALL| | 

| |LIFO| L J | 

j c j , 


LIFO 

linel 

line2 


«- 

| &END j 

j- -- - 



CLRXEC1 00319 

CLEXEC1 00320 
CLEXEC1 00321 
CL EXEC 1 00321 

CLEXEC1 00322 
CLEXEC1 00323 
CLEXEC1 00323 
CLEXEC1 00325 


Stack 'linel*, «line2*, ..., in the console input 
buffer without tokenizing then. The lines are normally 
stacked FIFO (first in, first out), but this can be 
changed by specifying the option 'LIPO* (last in, first 
out). The lines are normally truncated at cclumn 72, 
but this can be avoided by specifying the eftion 'ALL'. 
The stateaent is terminated by a line in which the 
string *6END* starts in column 1. 
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CtSXECl 00328 
CLEXECl 00329 
CLEXECl 00330 
CLEXEC1 00332 
CLEXEC1 00334 
CLEXECl 00337 
CLEXEC1 00339 
CLEXEC1 00340 
CLEXECl 00341 


f--- 

| SBEGTYPE 

1 (ALL] | 

-- .J 

linel 


line2 

• • t 


t n 


| SEND | 

1 

i- 



CLEXECl 00344 
CLEXEC1 00346 
CLEXEC1 00346 
CLEXECl 00347 
CLEXEC1 00349 


Type * linel', »line2', ... at the ccnsole, without 
tokenizing then. The lines ace normally truncated at 
column 72, but this can be avoided by specifying the 
option 'ALL'. The statement is termicated by a line 
which the the string 'BEND* starts in column 1. 


CL EX EC 1 00352 

CLEXEC1 00353 
CLEXEC1 00354 


Note: The Logical Line End character is a 
hexadecimal *15'. CMS routines will net process the 
symbolic line end character 


CLEXEC1 00358 ,-—, 

CLEXEC1 00359 | 6C0NTINUE j J 

CLEXEC1 00360 «- « 


CL EXEC 1 00363 

CLEXEC1 00364 
CLEXEC1 00365 
CLEXEC1 00366 


A no-op used in conjunction with an fXEC label (for 
example, -LAB 6C0NTINBE) to provide a branch address 
for &ERROR, 6GOTO, and other conditional branching 
stateme nts. 


CLEXSC1 00374 
CLEXEC1 00375 
CL EXEC 1 00376 

CLEXEC1 00377 
CLEXEC1 00378 
CL EX EC 1 00379 

CLEXEC1 00380 
CLEXEC1 00381 


! 

r i 

r i 

r i 

-1 

1 

6C0NTB0L | 

| OFF | 

j TIME | 

I PACK | 

1 

1 

| ERROR) 

| NOTIME| 

) NOPACK ) 

1 


|CMS | 

L J 

L J 

1 

1 

(ALL i 

L J 



1 

1 

_1 


CLEXECl 00385 
CLEXEC1 00386 
CLEXEC1 00387 


Set, until further notice, the characteristics of the 
summary of execution, which is automatically printed at 
the console. 


CLEXEC1 00390 
CLEXEC1 00391 
CLEXECl 00392 


OFF Do not type CMS commands as they are executed 

in this EXEC procedure, nor any return codes 
which may result. 


CLEXEC1 00394 
CLEXEC1 00395 
CLEXEC1 09396 


ERROR Type out CMS commands which result in a 
non-zero return code, and type the return 
code. 
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CLEXEC1 
CLEXEC1 

CLEXEC1 
C L EX EC 1 
CLEXSCI 

CL EX EC 1 
CLBXEC1 
CLEXECl 

CLEXECl 

CLEXEC1 


CLEXECl 
CL EX SCI 

CLEXEC1 

CLEXECl 
CLEXEC1 

CLEXEC1 

CLEXEC1 
CLEXEC1 


CLEXEC 1 
CLEXEC1 
CLEXEC1 

CLEXEC1 
CLEXEC1 
CL EX EC 1 
CLEXEC1 
CL EXEC 1 
CLEXEC1 
CLEXEC1 
CLEXEC1 
CLEXEC1 
CLEXEC1 
CLEXEC1 
CLEXECl 


CLEXEC1 
CLEXEC1 
CLEXEC1 
CLEXECt 
CLEXECt 
CLEXECt 


00398 

O0UOO 


CHS Type out each CMS conaand as it is executed, 

and type the return code if it is net zero. 


00402 

00403 

00404 


ALL Type out every executable statenent as it is 

executed, and type any non-zero return codes 
from CMS coanands. 


00406 

00407 

00408 


TIME Include the tine-of-day value with each CMS 

coaaand printed in the sunaary. Effective 
only if CMS or ALL is set. 


00410 

00411 


NOTIHE Do not include the tine-of-day value with CMS 
coaaands. 


00416 

00418 

00421 

00424 

00425 

00428 


PACK Pack the lines of the sunaary sc that surplus 

blanks are reaoved. 

NOPACK Do not pack the lines of the sunaary. 

On entry to an EXEC file, the default'settings for the 
file are: 

CMS NOTIHE PACK 


00430 Each group of options reaains set urtil explicitly 

00431 reset. 


00439 ,-, 

00440 | &EBBOB | action | 

00441 i-• 


00445 

00446 

00447 

00447 

00448 

00449 

00450 

00450 

00451 

00452 

00452 

00454 


Until instructed otherwise, execute 'action* following 
any CHS coaaand which yields an error return cede (that 
is, a return code which is not zero). The action aay 
be any executable statenent. What happens next depends 
uporuthe type and consequences of the action. If it is 
itself a CMS coaaand which also yields an errer return 
code, then the EXEC interpreter types an error nessage 
and exits froa the file; otherwise (unless the acticn 
causes a transfer of control) execution resuaes at the 
line following the CHS coaaand which caused tie acticn 
to be executed. On entry to an EXEC file, the action 
is set to the null statenent (that is, EC0NTINU2). 


<V0462 
0 0463 
00464 
00465 
00466 
00467 


r - - - --- 

f Sr i 

| SEXIT j | return-code| 

S j t 2 8 

S I ■» 

a- __ _ . _ - 


-s 

I 
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#LEXEC1 00472 


Exit froti the EXEC file with the given return cede. 


CLEXBC1 

00482 

i- 

-- 

—i 

CL EXEC 1 

00483 

| SIF | 

C tok 1} (EQ) (toJc2) 

i 

CLEXEC1 

00484 

1 1 

(6S } (NE) [&S ) 

J 

CLEXEC1 

00485 

1 1 

(&* } (LT) (&* J executable stateaent 

1 

CLEXEC 1 

00486 

1 i 

(LE) 


CLEXEC1 

00487 

1 1 

(GT) 


CLEXEC1 

00488 

I 1 

(GE) 

1 

cj py pr* 1 

00489 

1 


—j 

L. Lt £» A Cv_. 1 




CLEX EC 1 

00493 

If the condition is satisfied. 

execute 

CLEXBCl 

00494 

'executable-stateaent•; otherwise proceed tc 

the next 

CL EX EC 1 

00495 

line. S$ aeans 'any of the arguaents SI, S2, . 

. , , 6ll' , 

CL EXEC 1 

00495 

and S* 

neans 'all of the arguaents SI, G2, . 

.., Gn ', 

CLEXEC1 

004 96 

where n 

= &INDEX* The coaparison is nuaeric if 

both of 

CLSXEC1 

00497 

the coaparands are nuaeric; otherwise they are 

treated 

CLEXBCl 

00498 

as character strings. 


CLEXEC 1 

00508 

( _ 

i ■ 


CLEXEC 1 

00509 

) &GOTO 

1 (TOP } | 


CLEXEC1 

00510 

1 

I (line-nuaber } | 


CLEXEC1 

00511 

1 

I (label ) | 


C LEXEC 1 

00512 

k— _ 

j 


CLEXEC1 

00516 

Transfer 

control to the top of the EXJEC file. 

to the 

CLEXEC1 

00518 

given line, or to the line starting with 'label 



CLEXEC1 00520 
CLEXEC1 00520 
CLEXEC 1 00521 

CLEXEC1 00522 
CLEXEC 1 00523 

CLEXEC1 00524 


The first character of a label aust be a hyphen (ainus 
sign). A label nay be attached to any executable 
statement, as the first token of the line. Scanning 
for a label starts on the line following the 6G0TQ 
stateaent, and (if unsuccessful) ends on the line above 
it. 


CLEXBC1 00533 
CLEXEC1 00534 
CLEXEC1 00535 
CLEXEC1 00536 
CLEX EC 1 00537 

CLHXEC1 00538 


I-T 

i ) r i I 

| SLOOP | (n ) | (a ) I I 

| | (label) | (condition) | t 

I I *■ J I 

•_____j 


CLEXEC1 00542 
CL EXEC 1 00543 

CLEXBC1 00544 


Loop through the following n lines, cr down to (and 
including) the line starting with 'label', for a tines, 
or until 'condition* is satisfied. 


CLEXBC1 C0545 The values of n and a (if given) aust be nuaeric; also 

CLEXEC1 00547 n aust be positive, and a aust not be negative. 


CLEXEC1 00548 


The first character of the label (if given) aust be a 
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CLEXEC1 00549 Rinas sign, and the label nust be attached, as the 
CLEXEC1 00549 first token of the line, to an executable statement 
CLEXEC1 00551 which lies below the 6L00P statement. 

CLEXEC1 00552 The fora of the condition (if given) is the sane as in 
CLEXEC1 00554 the SIF statement, that is: 


CLEXEC1 

00559 

{toklj 

(EQ) 

(tok2) 

CLEXEC1 

*0560 

(&* } 

(NE) 

(&$ ) 

CLEXEC1 

00561 

{&* } 

(LTJ 

(6* } 

CLEXEC1 

00562 


{LE} 


CLEXEC1 

0*563 


{GT) 


CLEXEC1 

00564 


(GE) 



CLEXEC1 C0577 
CLEXEC1 00578 
CLEXBC1 00579 


j SPUNCH | tokl [ tok2 «... J 


CLEXEC1 00583 
CLEXEC1 00504 
CLEXEC1 00585 
CLBXBC1 00587 
CLEX EC 1 00588 


Punch a card containing 'iokl', *tok2', .... The card 
will be padded with blanks, or truncated, as necessary 
to fill an eighty-coluan card. The tokens, as punched, 
will be separated froa each other by a single blame 
(see &B EG PUNCH) • 


CLEXEC1 00598 
CLEXEC1 00599 
CLEXEC1 00600 
CLEXBC1 00601 
CLEXEC1 00602 
CLEXEC1 00603 
CLEXEC1 00604 
CLEXEC1 00605 



CLEXEC1 00609 Bead the next n lines froa the terminal and treat then 
CLEXEC1 00610 as if they had been in the EXEC file; cr read a single 
CLEXEC1 *0611 line, assign the tokens in it to the arguments 61, 62, 
CLEXEC1 00612 •••, and reset &INDEX to the number of arguments thus 
CLEXEC1 00612 set; or read a single line and assign the tokens in it 
CLEXEC1 00614 to the variables *var1®, *var2', .... 

Q 

CLEXEC1 00615 If n is given, reading froa the terminal stops when n 
CLEXEC1 00616 lines have been read, or when - a 6LOOP statement or a 
CLEXEC1 00617 statement which transfers control is encountered. If an 
CLEXEC1 00617 6READ statement is encountered, the Duaber cf lines tc 
CLEXEC1 00619 be read by it is added to tha number outstanding. 

The variables ®var1', 4 var2“, ..., if given, are 
scanned in the saae way as if they appeared cn the 
left-hand side of an assignment statement (see 5AHGS) . 


CLEXEC1 00620 
CLEXEC1 00621 
CLEXECt 00623 




IBB CONFIDENTIAL 


CLEXEC1 

00631 

CLEXBC1 

00632 

CLEXEC 1 

0 0633- 

CLEXEC1 

00634 

CLEXEC1 

00635 

CLEXBC1 

00636 

CLEXEC1 

00641 

CLEXEC1 

00642 

CLEXEC1 

00643 

CLEXEC1 

00644 

CL EX EC 1 

00645 

CLEXEC1 

00646 

CLEXBC1 

00648 


CLEXEC1 

00651 

CLEXEC1 

00652 

CLEXEC1 

00653 

CLEXEC1 

00654 

CLEXEC1 

00655 

CLEXEC1 

00656 

CLEXEC1 

00658 


CLEXEC1 

00663 

CL EXEC 1 

00664 

CLEXEC1 

00665 

CLEXEC1 

00666 

CLEXEC1 

00667 

CLEXEC1 

00668 

CLEXEC1 

00671 

CL EX EC 1 

00672 

CLEXBC1 

00672 

CLEXEC1 

00673 

CLEXEC1 

00674 

CLEXEC1 

00674 

CLEXEC1 

00675 


CLEXEC1 

00677 

CLEXEC1 

00678 

CLEXEC1 

00679 

CLEXEC1 

00680 

CLEXEC1 

*0681 

CLEXEC1 

00685 

CLEX EC 1 

00687 

CLEXBC1 

00689 

CLEXEC1 

00690 

CL EXSCI 

00693 


I I r i 

| &SKIP | | n | 

I till 

I I L J 


If d > 0, skip the next n lines of the EXEC file. If n 
< 0transfer control to the line which is -n lines 
above the current line. If n * 0, transfer control to 
the next line. If during the SKIP operation, 
end—of-file is reached, the EXEC file will exit with 
return to CBS. If n specifies a position before the 
beginning of the EXEC file, an 6SKIP error will result. 


<- - - 1 

j I r i I 

| &SP&CE | | a | I 

I fill I 

I I L J I 

j_i 


Type n blank lines at the terminal. 


« 

I 

I 

I 


i----1 

i I r i i 

| SSTACK | IPIFOI £tok 1 [tok2 ... ]] j 

I I ILIPOI | 

I I *■ J I 

»_ _I 


Stack a line in the terninal input buffer containing 
’tokl', a tok2', ..., or stack a null lice if the tokens 
are absent. The line is nornally stacked *F1FC' (first 
in, first out), but this can be changed by specifying 
the option *LIFO # (last in, first out). The tokens, as 
stacked, will be separated fron each ether by a single 
blank. 


Note: The Logical Line End character is a hexadeciaal 
*15*. CBS routines will not process tke synbclic 
character *#• as a logical line end character, that is, 
will not translate it to XH5* unless the user follows 
the following procedures: 

1. changes or turns off the logical line end 
character via the CP coaaand, TERMINAL. 

2. uses EDIT*s ALTER subcoaaand to cause the 
EDITOR to autonatically convert tie character 
"•"or soae other character tc X*15*» 


122 



IBM CONFIDENTIAL 


CLEXEC1 

00700 

f... 

—i 

CLEXEC1 

00701 

1 1 

r i r t 1 

CLEXEC1 

00702 

| 6TIME | 

|ON J |RESET| i 

CLEXEC1 

00703 

1 1 

| OFPJ (TYPE | i 

CLEXEC1 

00704 

1 1 

L i L J I 

CLEXEC1 

00705 

* 

.. 1 

CLEXEC1 

00709 

This statement can be used to type tiling informaticn 

CLEXEC1 

00710 

in the fora: 

CL El SCI 

00713 

T*x. 

xx/y.yy hh:aa:ss 

C LEX EC 1 

00716 

where 


CLEXEC1 

00719 

s.xx 

is the virtual CPU tiae used since it 

CLEXEC1 

00721 


was last reset in the current EXEC tile. 

CLEXEC1 

00723 

y. yy 

is the total CPU tiae used since it was 

CL EX EC 1 

00725 


last reset in the current EXiC file, and 

CLEXEC1 

00727 

hh :■ 

a:ss Is the tiae of day in 

CLEXEC1 

00728 


hours:ainutes:seconds. 

CL EXEC 1 

00731 

The CPU times are set to zero before the execution cf 

CLEX EC 1 

00732 

the first 

stateaeni in the EXEC file, and are reset 

CLEXEC1 

00734 

whenever 

the tiaing information is printed. 

CLEXEC1 

00737 

ON 

Reset the CPU tines before every CHS ccanand. 

CLEXEC1 

00738 


and print the tiaing inforaaticn on return. 

CLEXEC1 

00738 


If &CONTBOL is set to CMS cr ALL, the 

CLEXEC 1 

n 0739 


printing of the tiaing infornation is 

CLEXEC1 

00740 


followed by a blank line. 

CLEXEC1 

00742 

OFP 

Do not autoaaticaliy reset the CFU tines 

CL EX EC 1 

00743 


before every CMS coanand, or print the tiaing 

CLEXEC1 

00743 


infornation on return. This is the initial 

CLEXEC1 

00744 


setting. 

CLEXEC1 

00747 

RESET 

Per fora an iaaediate reset of the CPU tines. 

CLEXEC1 

00749 

TYPE 

Type the current tiaing infcraaticn (and 

CLEXEC1 

00750 


reset the CPU tines) . 

CLEX EC 1 

00754 

r— 


CLEXEC1 

00755 

| &TYPJ3 | 

tolcl [ tok2 ... ] | 

CLEXEC1 

00756 

s_ 

j 

CLEXEC1 

00759 

Print at 

the terninal a line containing 'tokl', •tok2‘. 

CLEXEC1 

00760 

• • •« The 

tokens, as typed, are separated ftoa each 

CLEXEC1 

00762 

other by 

a single blank (see &BEG1YPE) . 
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CLEXEC2 


CLEXEC2 
CLEXEC2 
CLEXEC2 
CL EX EC 2 
CLEXBC2 
CLEXEC2 
CLEXEC2 


CLEXEC2 

CLEXEC2 

CLEXEC2 

CLEXEC2 
CL EX EC 2 
CL EXEC 2 
CLEXEC2 

CLEXEC2 

CLEXEC2 

CLEXEC2 

CLEXEC2 

CLEXEC 2 

CLEXEC2 


CLEXEC2 

CLEXEC2 

CLEXEC2 

CLEXEC2 

CLEXEC2 

CLEXEC2 


CL EXEC2 
CLEXEC2 
CLEXEC2 

CLEXEC2 

CLEXEC2 

CLEXEC2 


00003 £uas&i2fl3 


00005 An EXEC built-in function consists of the nans of the 

00006 function and, usually, a list *of arguments. Built-in 

00007 function names are EXEC keywords, and start with an 

00007 aapersand. With the exception of SLITfBAL, they arc 

00008 recognized only if they appear as the token following the 

00009 equal sign of an assignaent statement. The details are as 

00010 follows. 


00020 ,- s 

00021 j 6C0NCAT 1 tokl £tok2 .. , ] | 

00022 « ---s 

00027 Concatenate 'tokl 1 , «tok2*, *•*, into a single icken, with a 
00027 aaxiaua length of eight. This function is reccgnized only 
90^28 on the right-hand side of an assignaent stateaent. For 
00029 exaaple: 

00032 6A = ** 

00035 

00037 SB = SCOMCAT XX SA 45 

00039 STYPE SB 

00042 This results in the printed lines 

00044 XX**45 


00053 ,-•, 

00054 | SDATATIPE j tok | 

00055 «-« 

00058 Has the value NUM or CHAB, depending cn the data type of 
00059 'tok 1 . This function is recognized only on the right-hand 

00^60 side of an assignaent stateaent. 


00063 i-, 

00064 | SLENGTH | tok | 

00065 i-* 

00068 Gives the nuaber of non-blank characters in *tck*. This 
00069 function is recognized only on the right-hand side of an 
00070 assignaent stateaent. 
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-LEX EC 2 

00073 

i - 1 



CLEXEC2 

00074 

| GLITERAL | tok | 



CLEXEC2 

O0075 

i-1 



CLEXEC2 

00079 

Use the literal value o£ • tok*. without substitution for 

any 

CLEXSC2 

00080 

EXEC variable which aay appear in it. 

This functicn 

is 

CLEXSC2 

00080 

recognized anywhere in an executable 

stateaent. 

For 

CLEXEC2 

00081 

exaaple: 



CLEXEC2 

00084 

ex = ** 



CLEXEC2 

00086 

6TYPE GLITERAL GX EQUALS GX 



CLEXEC2 

00089 

This results in the printed line: 



CLEXEC2 

00091 

GX EQUALS ** 




CLEXEC2 

00097 

i— 

-1 


CLEXEC2 

00098 

| GSUBSTR | tok i 

[j] I 


CLEXEC2 

00099 

s_ 

_ a 


CLEXEC2 

00105 

Extract that part 

of *tok* which starts at character i. 

with 

CLEXEC2 

00105 

length j; or which 

starts at character i and runs tc the 

end 

CLEXEC2 

00106 

of the token. The value of i (and i if given) aust 

be 

CLEXEC2 

00107 

nu aerie; also i 

aust be positive, and j aust not 

fce 

CLEXBC2 

00108 

negative. This 

function is recognized ccly cn 

the 

CLEXEC2 

00109 

right-hand side of 

an assignaent statement. 


CLEXEC2 

00112 

&A * GSUBSTR 

ABCDE 2 3 


CLEXEC2 

00114 

STfPE GA 



CLEXEC2 

00117 

This results in the printed line: 


CLEXEC2 

00119 

BCD 
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CLEXEC2 


CLEXEC2 

CLEXEC2 

CLEXEC2 

CLEXEC2 

CLEXEC2 

CLEXEC2 

CLEXSC2 

CLEXEC2 

CLEXEC2 

CLEXEC2 

CLEXEC2 

CLEXEC2 
CL EXEC 2 

CLEXEC2 
CLEXSC2 
CLEXEC 2 

CLEXEC2 

CLEXEC2 
CLEX EC 2 
CLEXEC2 
CLEXEC2 
CLEXSC2 

CLEXEC2 
CLEXEC2 
CLEXEC2 
CLEXEC2 
CLEXEC2 

CLEXEC2 

CLEXEC2 

CLEXEC2 


CLEXEC2 


CLEXEC2 

CLEXEC2 

CLEXEC2 


00122 

Sgaslai latiabisa 

00125 

Certain EXEC variables are reserved for special purposes. 

00128 

00129 

60 

Initialized to the filename of the EXEC file 
being executed. 

00131 

00133 

61, 62, . 

.. Initialized to the arguments ’argl*, ’ai.g2*, 
which are passed to the EXEC file. 

00135 

00136 

00137 

6INDEX 

Initialized to the number of arguments passed to 
the EXEC file. Can take only integral numeric 
values. 

00139 

00140 

''oni 

SHETCODE 

Set after every CMS command to the return 
(completion) code of the CHS ccamand. Can take 
only integral numeric values. 

00143 

^0145 

6LINBN0M 

Contains the current line number of the EXEC 
file. Cannot be set explicitly. 

00147 

00148 

00149 

6GLOBAL 

Contains the recursion level cf the EXEC 

interpreter (e.g. 1, 2, ...). Cannot be set 

ex plicitly. 

00152 

6GLOBAL0, 

6GLOBAL1, ... 6GLOBAL9 

no 154 
00155 
00156 
00157 
00158 


Can hold only integral numeric values. The are 
initially set to one. Unlike ether EXEC 
variables, these can be used to communicate 
between different levels ct the EXEC 
interpreter. 

00160 

00161 

00161 

00162 

00163 

6READFLAG 

Contains the value CONSOLE or STACK, depending 
on whether an attempt to read frem the console 
would obtain a physical line frem the real 
console, or a logical line froa the console 
input stack. Cannot be set explicitly. 

00165 

O0166 

00167 

6TYPBFLAG 

Has the setting RT or HT, depending on the value 
of the console output flag. Cannot be set 
explicitly. 


00171 Hlscellanep yjs No te s 


00173 SalaaaS ifJifiSaiAaa* Except where otherwise stated, data 
00174 lines read from an EXEC file are truncated at column 72, and 
00177 lines read froa the console are truncated at column 130. 
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CLBIEC2 00179 an acame nt is iilsl£]S£* An argument can be set to 

CLEXEC2 00180 blanks by assigning it a percent sign (*) wten invoking the 
CLEXEC2 00181 EXEC file, in the SARGS statement, or in the SFEAC A6GS 

CLEXEC2 00182 stateaent. A variable can also be set to Hanks t y 

CLEXEC2 00183 assigning it to the double-guotation mark in the SPEAD VARS 

CLEXEC2 00184 stateaent, Por example: 

CLEXEC2 00186 SARGS A % B 

CL EXSC2 00187 

CLEXRC2 00188 STIPE SI S2 ** S3 

CLEXEC2 00190 This results in the printed line: 

CL EXEC 2 00192 A ** B 


CLBXEC2 00197 HissAua end-toke n: A final token of blanks is acded to any 
CLEXEC2 00198 EXEC stateaent which is syntactically invalid if in doing sc 

CLEXEC2 00200 the stateaent becones syntactically valid. for example: 

C LEXEC 2 00203 SBLANK = 

CLEXEC2 00205 STIPE 

CLEXSC2 00207 SLOOP 3 SX NE 


CLEXEC2 00210 Synt ax note : An EXEC stateaent is interpreted anew each tine 

CLEXEC2 00211 it is executed. It follows that the saie line aay be 

CLEXEC2 00212 executed as an entirely different stateaect cn different 

CL EX EC 2 00213 occasions. For exaaple: 

SARGS -XX SGOTO DUMMY SLITERAL SLITERAL EC " XX SXf 
SSKP * 0 

-L S8 67 S6 65 64 S3 62 61 
SSKIP SSKP 

SARGS SISPRINT FILE TYPE 
SSKP = 3 
SGOTO -L 

CLEXEC2 00227 The stateaent labelled -L will be executed the first tine 

CLEXEC2 00228 * as: 

CLEXEC2 00230 SIF XX EQ SLITERAL SGOTO -XX 

CLEXEC2 O0232 and the second tiae as: 

CLEXEC2 00234 TYPE FILE SYSPRINT 

CLEXEC2 00235 Note, however, the exceptions given below under 'Assignment 

CLEXEC2 00237 stateaent* and 'SLOOP stateaent*. 


0 

CLEXBC2 00240 Assi g naent s tateaent : The token immediately fcllcwiny the 
CLEXEC2 00241 target of an assignaent stateaent must be a literal egual 
CLEXEC2 00242 sign, and not an EXEC variable which has the value of an 


CLEXEC2 00216 
CLEXEC2 00217 
CLEXEC2 00218 
CLEXEC2 00219 
CLEXEC2 00220 
CLEXEC2 00221 
CLEXEC2 00222 
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CL EX EC2 
CLEXEC2 
CLEXEC2 
CLEXEC2 
CLEXEC2 
CLEXEC2 


CLEXEC2 
CLEX EC 2 
CLEXEC2 
CL EX EC 2 
CLEXEC2 
CLEXEC2 
CLEXEC2 
CLEXEC2 
CLEXEC2 
CL EX EC 2 
CLEXEC2 

CLEXEC2 
CL EX EC 2 
CLEXEC2 
CLEXEC2 

CLEXEC2 

CLEXEC2 

CLEXEC2 

CLEXEC2 
CLEXEC2 
CLEXEC2 
CLEXEC2 
CL EXEC 2 

CLEXEC2 

CLEXEC 7 . 


CLEXEC2 

CLEXEC2 
CLEXEC2 
CLEXEC2 
CL EX EC2 


CLEXEC2 

CLEXEC 2 
CL EX EC 2 
CLEX EC2 
CLEXEC2 
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00242 

00243 

00244 

00245 

00245 

OQ247 


equal sign. Conversely, if an equal sign is tc be the first 
token following a control word, then it aust be given as an 
EXEC variable which has the value of an equal sign, and not 
as a literal equal sign; otherwise the statement will be 
interpreted as an assignment, and (if it is valid as such) 
the control word will thereafter be treated as a variable. 


00249 

00250 

00250 

00251 

00252 

00253 

00253 

00254 

00255 

00256 

00257 


SLOO P statement: The decision on which term of the sLCCP 
statement is intended is based on the number of tokens in 
the stateaent after scanning and substitution fcr any EXEC 
variables. If the conditional form is intended, and the 
first comparand or the comparator is given in the fern of an 
EXEC variable, then the value of the variable aust not be 
blank at the tiae the stateaent is interpreted. In the 
conditional fora, the tokens forming the conditional phrase 
are saved in an unscanned format, so that substitution for 
any EXEC variables can be perforaed dynamically before each 
execution of the loop. For example: 


00260 

00261 

00262 

00263 


SLOOP 2 SX EQ 2 
SX = 6X + 1 
STIPE SX 


00265 


This results in the printed lines: 


00267 1 

O0268 2 


00270 
00271 
00272 
00273 
o 0274 


b. SX = XXZ 

ST * SLITERAL ASti 
SLOOP 2 SX EQ SLITERAL S 
SX = SS0BSTR SI 2 1 
STYPE SX 


00276 


This will result in the single printed line: 


AA 278 


S 


00283 

00284 
0 0285 
C 0285 
o 0287 


SERROB stateaegt: The words following the SEBbOB control 
word are saved in an unscanned format, and substitution for 
any variables among them is performed dynamically (if the 
occasion arises) after obtaining a non zero (errer) 
completion code froa a subsequent CMS command. 


00289 Sea££i! for labels: The search for a label invclves 
00290 examination of only the first word on each line. It follows 
00291 that care aust be taken to avoid the use of any label names 
O0291 which may appear as the first word of a line within the 
00293 scope of a SBEGTIPE, SBEGPUNCH or 6BEGSTACK statement. 
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CLEXBC2 

CLEXEC2 
CLEXEC2 

CLEXEC2 

CLEXEC2 

CLEXEC2 

CLEXEC2 

CL EX SC 2 

CLEXEC2 

CLEXEC2 


CLEXBC2 


CLEXBC2 

CLEXEC2 

CLEXEC2 

CLEX EC 2 

CLEXEC2 

CLEXEC2 


CLEIEC2 


CLEXEC2 
CL EX EC 2 
CLEXEC2 
CL EXEC 2 

CLEXEC2 

CLEXEC2 

CLEXEC2 

CL EX EC 2 
CLEXEC2 

CLEXEC2 
CL EX EC 2 
CLEXEC2 
CLEXEC2 
CLEXEC2 
CLEXEC2 


00295 Remo val of l eading z eros : Leading zeros can be zeacved frca 
C0296 a nuaeric quantity by performing any arithnetic operation cn 
00298 it. Por example: 


0 0 301 
00303 
00305 
o 0307 


SX = 000012 
STIPE SX 
SX * SX «■ 0 
STYPE SX 


00310 This results in the printed lines: 

00312 000012 

00314 12 


00317 I»El2ieHtati2a a eviction s: 


No aora than 30 arguaents can be passed to an EX EC 
file. 

No aore than 19 tokens can appear in an EXEC statement. 

No aore than 4 nested loops aay be specified. 

No aore than 19 levels of recursion can be handled by 
the EXEC interpreter. 


00336 Hesp o nses 


00338 As each CMS comaand in the EXEC file is processed, it is 

00339 typed at the terainal along with any ncn-zerc return code. 

00340 The SCONTBOL coaaand can be used to augaent or reduce the 

00341 aaount of typing done during execution. 

00342 If the EXEC interpreter finds an error, it will type the 
00343 aessage: 

00345 ERBOB IN EXEC FILE rn, LINE n - description cf error 


00321 1. 

00322 

00325 2. 

00328 3. 

00331 4. 

00332 


00346 where "description of error" will be one of the following 

rt 0348 conditions with its appropriate return code: 


00352 
00354 
C 0356 
00358 
00360 
00362 


(802) SSKIP OB SGOTO EBBOB 

(804) TOO MANY ARGUMENTS 

(805) MAX DEPTH OF LOOP NESTING EXCEEDED 

(806) DISK OB TEBMINAL BEAD ERROR 

(807) INVALID SYNTAX 

(808) INVALID FOBH OF CONDITION 
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CLEXEC2 

0*364 

(809) 

CLEXEC2 

00366 

(810) 

CLEXBC2 

00368 

(811) 

CLEXEC2 

00370 

(812) 

CLEXEC2 

00372 

(813) 

CLEXEC2 

00374 

(814) 

CLEXEC2 

00376 

(815) 

CLEXEC2 

00378 

(816) 


INVALID ASSIGNMENT 

MISUSE OF SP.ECIAL VARIABLE 

ERROB IN 6ERROR ACTION 

CONVEBSION EHBOR 

TOO MANY TOKENS IN STATEMENT 

MISUSE OF BUILT-IN FUNCTION 

EOF FOUND IN LOOP 

INVALID CONTROL WORD 
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CLFILEDE 00005 FILED EF 


CLFILEDE 00008 
CLFILEDE 00009 
CLFILEDE 00O10 
CLFILEDE 00011 
CLFILEDE 00012 
CLFILEDE 00^12 
CLFILEDE 00013 

CLFILEDE 00014 
CLFILEDE 00016 

CLFILEDE DOC 18 


The FILEDEF conaand is used to allow the OS sinulaticn 
routines to simulate the functions of the JCL Data 
Definition (DD) card. It provides device independence by 
allowing the user to specify the I/O device as well as file 
characteristics to be used by a pregrao at execution tine. 
FILEDEF aay be used only with programs using OS lacros and 
functions. 

If a FILEDEF is not issued for a file within an CS prograa, 
a default FILEDEF is issued by CHS. Its foraat is 

FILEDEF ddnaae DISK FILE ddnaae A1 

where ddnaae is the ddnaae in the DCB in the prograi. 


CLFILEDE 00020 
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CLFILEDE 

00033 

r~ 




—i 

CLFILEDE 

00034 

1 


1 

r i r 1 


CLFILEDE 

00035 

1 

PILEDBF 

1 

|ddnaae| | TERMINAL [(opticnA* ] 1 


CLFILEDE 

00036 

8 

FI 

1 

<nn > 8 1 


CLFILEDE 

00037 

1 


1 

8* 8 8 1 


CLFILEDE 

00038 

1 


1 

w J 8 1 


CLFILEDE 

00039 

1 


1 

8 PRINTER 8 


CLFILEDE 

00040 

1 


1 

| PUNCH 8 


CLFILEDE 

00041 

1 


1 

8 READER ! 

]l 

CLFILEDE 

00042 

1 


1 

< > £ (opticnD* 

CLFILEDE 

00043 



1 

i 1 


CLFILEDE 

"0044 

1 



j { DISK [ fn ft [ fa ] [ jcpticnB* ]) | 


CLFILEDE 

"0045 



1 

8 { DUMMY }1 


CLFILEDE 

00046 

1 


8 

8 TAPi [ (optionC* ] 8 


CLFILEDE 

00"4 7 

1 


1 

I CLEAR 1 


CLPILEDE 

00048 

9 


1 

«. -3 


CLFILEDE 

"0049 

8 


8 



CLFILEDE 

00050 



8 

♦optionA; [U£CAS£1LOWCASE ] 


CLFILEDE 

00051 



8 



CLFILEDE 

00052 

1 


8 

♦options: [KEYLEN n] 


CLFILEDE 

00053 

1 


i 

[XTENT In J 50} ] 


CLFILEDE 

"0C54 

1 


8 

[LIMCT nj 


CLFILEDE 

00055 

1 


1 

[OPTCD (A | E | F | R } ] 


CLFILEDE 

00056 

« 


f 

[DISP MOD] 


CLFILEDE 

00057 

1 


1 



CLFILEDE 

O0"60 

1 


8 

♦optionC; [7TRACK J 9TRACK ] 


CLPILEDE 

00061. 

1 


1 

£ TRTCH(O|OC|OT|E|ETJ 3 


CLFILEDE 

00062 

1 


1 

[DEN £2001556|800J 1600} ] 


CLFILEDE 

00063 

1 


1 



CLFILEDE 

00064 

1 


8 

♦optionD: [PERM] 


CLFILEDE 

00065 

1 



[CflANGEINOCHANGE ] 


CLFILEDE 

00066 

1 


8 

[R EC PM (FJFBJVIVBJUIVS|VBS|FS|FBS|A|MJ 3 


CLFILEDE 

00067 

1 


8 

£ LRECL n 3 


CLFILEDE 

00068 

1 



£ BLOCK n] 


CLPILEDE 

00069 

1 


8 



CLFILEDE 

00070 



_ 

-- - - —- ■ ----—--—- 

—J 


CLFILEDE 00075 
CL P ILEDE 00076 
CLFILEDE 00076 
CLFILEDE 00078 


If no parameters are entered with the conand, a list of 
current filetypes is typed at the user’s teninal including 
the ddnaae; device type and; if device tyje is DISK, the 
filenaae and filetype. 


CLFILEDE 00080 
CLFILEDE "0083 
CLFILEDE 00084 
CLFILEDE 00085 
CLPILEDE "0086 
CLFILEDE 00086 
CLFILEDE 00088 


ddnaae specifies the naae by which the file is 
nn referred to in the user's program. If a nuabcr no 

is specified, it is translated to a FCETFAN* data 
definition name of FTnnFOOI. If the "CLEAF" opticn 
is in effect, ddnaae aay be specified as to 

indicate that all file definitions ret entered 
with the "PERM" option are to be renoved. 


CLFILEDE 00092 - 

CLFILEDE 00094 * The FORTRAN processors are IBM Program Products. 
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CLFILEDB 00096 pevices 

CLFILEDE 00100 TERMINAL user terminal (terminal I/O may not be tlccked) 

CLFILEDB 00103 DISK disk 

CLFILEDB 00105 PRINTER spooled printer 

CLFILEDE 00107 PUNCH spooled punch 

CLFILEDE 00109 READER spooled card reader (card reader I/O >ay net be 

CLFILEDE n 0110 blocked) 

CLFILEDE 00113 TAPi magnetic tape (i is the symbolic number of the 

CLFILEDE 00114 tape. .It is either 1, 2, 3, or 4 representing 

CLFILEDE 00115 virtual units 187, 182, 183 arid 184 respectively.) 

CLFILEDE 00118 DUMMY indicates that no real I/O is to take place for a 

CLFILEDE 00119 disk data set. 

CLFILEDE 00122 CLEAR removes any existing definition fer the specified 

CLFILEDE 00123 ddname. 

CLFILEDE 00126 If the device is DISK, the CMS fileid nay he specified. If 

CLFILEDE 00126 none is entered, the default file identificaticn is "FILE 
CLFILEDE 00127 ddnaae A1. W 

CLFILEDE 00132 fn CMS filename for the file referred tc by ddDame 

CLFILEDE 00135 ft CMS filetype for the file referred tc by ddnaae 

CLFILEDB 00138 fa CHS fileaode for the file referred tc by ddnaae 


CLFILEDE 00141 Options 

CLFILEDE 00142 If an option is specified that is invalid for the device 
CLFILEDB 00144 type, an error aessage is issued. Figure 17 shows valid 
CLFILEDE 00145 options for each device type. 

CLFILEDE 00149 UPC^ SE indicates that all terainal input data is to 
CLFILEDE 00150 be translated to uppercase. 

CLFILEDE n 0153 LOHCASE indicates that all terainal input data is to 
CLFILEDE 00153 reaain as typed in, and not translated cn 
CLFILEDE 00154 output. 

CLFILEDE 00156 KEYLEN nn specifies the size of the key (nn bytes). 
CLFILEDE 00158 This option is used only for EEAM files. 

CLFILEDE 00160 XTENT nn specifies the number of records in the extent 
CLFILEDE oo161 for the file (nn bytes). This option is used 
CLFILEDE 00162 Only for BDAM files. 
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CLFILEDE 00164 LIBCT 00 
CLFILEDE 00165 
CLFILEDE 00166 


specifies the number of extra tracics or 
blocks to be searched (nn bytes). This 
option is used for BDAM files. 


CLFILEDE 00168 OPTCD a 
CLFILEDE 00169 
CLFILEDE 00169 
CLFILEDE 00170 


specifies the direct access search processing 
desired. 4 may be any coabicaticn cf up tc 
three of the following: (A and fi are 

autually exclusive.) 


CLFILEDE 00173 
CLFILEDE 00175 
CLFILEDE 00177 
CLFILEDE 00179 


A Actual device addressing 

E Extended search 

F Feedback addressing 

H Relative block addressing 


CLFILEDE 00183 DISP MOD 
CLFILEDE 00183 
CLFILEDE 00184 


indicates that the read/write pointer is to 
be positioned after the last record in the 
disk file. 


CLFILEDE 00192 
CLFILEDE 00193 
CLFILEDE 00194 
CLFILEDE 00195 


r i 

| 7TRACK | 
| 9TRACR | 


<L J 


indicates tape setting. 


CLFILEDE 00200 TRTCB i 
CLFILEDE 00201 
CLFILEDE '''0202 


specifies Tape Recording Technique, 
determined by referring to the 
chart: 


i can be, 
following 


CLFILEDE 00209 


CLFILEDE 

00210 

1 i 

PARITI 

| CONVERTER 

TRANSLATOR 

1 

CLFILEDE 

00211 

] —- 



____■ 

CLFILEDE 

00212 

| OC 

odd 

) on 

cf f 


CLFILEDE 

00213 

1 OT 

odd 

| off 

on 


CLFILEDE 

00214 

1 0 

odd 

| off 

cff 


CLFILEDE 

00215 

5 ET 

even 

| off 

on 


CLFILEDE 

00216 

8 E 

even 

1 off 

off 


CLFILEDE 

00217 

. 


_- - __ r :_. 

- - _ -_ . 

_j 


CLFILEDE 00223 DEN den 
CLFILEDE 00224 
CLFILEDE 00225 
CLFILEDE 00226 


specifies tape density: deu can be 200, 556, 
800 # or 1600 bytes per inch. If 200 cr 556 is 
specified, 7TRACK is assumed. If 80C or 1600 
is specified 9TRACK is assumed. 


CLFILEDE 00231 PERM 
CLFILEDE 00231 
CLFILEDE 00232 
CLFILEDE 00232 
CLFILEDE D0233 
CLFILEDE ^0235 


specifies that this definition is to remain 
in effect until it is either explicitly 
cleared or has been changed with a new 
FILEDEF with the CHANGE opticn. If EEBM is 
not specified, the definition will be cleared 
when a FILEDEF * CLEAR is executed. 


CLFILEDE 00238 CHANGE 


specifies that if a file definition exists 
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CLFILEDE 

00238 

for 

the specified 

ddnane, the new 

file 

CLFILEDE 

00239 

definition is to replace the cld cce. 


CLFILEDE 

00242 

NOCHANGE specifies that if a 

file definition 

ex ists 

CLFILEDE 

00242 

for 

the specified adnane, it is nrt 

to fce 

CLFILEDE 

00243 

replaced. 



CLFILEDE 

0 0245 

RECFH a the 

record foraat of 

the file is specified as 

CLFILEDE 

00247 

a# 

where a is one of 

the follcwing: 


CLFILEDE 

00249 

F 

fixed 



CLFILEDE 

00251 

FB 

fixed blocked 



CLFILEDE 

00253 

V 

variable 



CLPILEDE 

00255 

VB 

variable blocked 


CLFILEDE 

00257 

u. 

undefined 



CLFILEDE 

00259 

FS, 

FBS fixed length. 

standard blocks 


CLFILEDE 

00261 

vs. 

VBS variable length, spanned records 


CLFILEDE 

00263 

*A 

ASA print control characters 


CLFILEDE 

00265 

*H 

aachine print 

control codes 


CLFILEDE 

00269 

* A and H «ay be 

used in conjunction with any of the 

valid 

CLFILEDE 

00270 

RECFH settings, (for exaaple, FA, FBA, VA, VEA, etc.) 



CLPILEDE 

CLFILEDE 

CLFILEDE 

00273 

00274 

00275 

LRECL 

nn 

logical record length of the file (nn 
LRECL should not exceed 32,767 bytes 
of OS restrictions. 

bytes). 
because 

CLFILEDE 

CLFILEDE 

CLPILEDE 

CLFILEDE 

00278 

00279 

00280 

00281 

BLOCK 

nn 

logical block of the file (nn bytes). 
BLOCK should not exceed 32,767 bytes 
of OS restrictions. BLOCK should be 
with TEBHINAL or READER devices. 

because 
not used 
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CLFILEDE 

"0292 

CLPILEDE 

0 0293 

CLFILEDE 

00294 

CLFILEDE 

C0295 

CLFILEDE 

00298 

CLFILEDE 

00299 

CLFILEDE 

003C0 

CLFILEDE 

00301 

CLFILEDE 

00302 

CLFILEDE 

00303 

CLFILEDE 

00304 

CLFILEDE 

00305 

CLFILEDE 

00306 

CLFILEDE 

"0307 

CLFILEDE 

0 0 303 

CLFILEDE 

00309 

CLFILEDE 

"0310 

CLFILEDE 

"0311 

CLFILEDE 

"0312 

CLFILEDE 

"0313 

CLFILEDE 

00314 

CLFILEDE 

00315 

CLFILEDE 

00317 

CLFILEDE 

00318 

CLFILEDE 

00321 

CLFILEDE 

00323 

CLFILEDE 

00324 

CLFILEDE 

00325 

CLFILEDE 

00328 

CLFILEDE 

00329 

CLFILEDE 

"0330 

CLFILEDE 

"0331 

CLFILEDE 

"0332 

CLFILEDE 

00335 

CLFILEDE 

"0337 

CLFILEDE 

00338 

CLFILEDE 

0 033 9 

CLFILEDE 

00343 

CLFILEDE 

00343 

CLFILEDE 

00344 

CLFILEDE 

00345 


| OPTION 

| UNIT RECORD | 

|PRINTER/PUNCH| 

| READER t 

TERMINAL 

| LUMMY | 

1 1 

J i 

TAPi 

| DISK | 

I 0PCASE 

1 



X 

t Nc | 



| LOWCASE 

1 



X 

|Cfticns| 



| LRECL 

1 

X 


X 

j Hec- I 

X 

I X | 

I BLOCK 

i 

X 


X 

| ssary | 

X 

I x t 

| RECFM 

1 

X 



j But | 

X 

1 x | 

| 7TRACK/9TRACK 

1 




i All | 

X 


| TRTCH 

1 




) Disk | 

X 7TRK 



1 




|Cpticns| 

ONLY 


j DEN 

1 




| Are | 

X 


9 KEYLEN 

1 




| Acc- | 


)X(UDAM) I 

J XT ENT 

1 




) epted| 


| X(BDAK) | 

| LIMCT 

1 




i 1 


|X(BEAM) | 

| OPTCD 

1 




1 1 


jX(BDAM) | 

1 DISP HOD 

1 




1 i 


1 x | 

| PERM 

1 

X 


X 

1 1 

A 

1 X | 

| NOCHANGE/CHANGE 
a_ 

1 

X 


X 

t 1 

X 

i X ] 


Figure 17. Valid File Characteristics for each Device 
Type for FILEDEF command 


Example 1 


| FILEDEF | SYSPRINT PRINTER (PERM RECFM F LfECL 133) J 

i...-____j 

Actisfl: When SYSPRINT is referred to in a user's program, 
the output written to it is spooled to the . virtual printer. 
The file is fixed-format with a logical record length cf 
133. The file definition may not be removed by the command 
FILEDEF * CLEAR. 


Example 2 


| FILEDEF | 05 READER (PERM RECFM F LRECL 80) | 

^ --- 1 


Actl og; When FT05P001 is referenced in a program, reading is 
done from the virtual spooled card reader* The file is 
fixed-length card image. The file definition may not be 
removed by the coaaand FILEDEF * CLEAR. 
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CLPILEDE 00348 

CLFILEDE 00350 
CLPILEDE 00351 
CLFILEDE 00352 

CLFILEDE 00355 
CLFILEDE 00356 
CLFILEDE 00358 


CLFILEDE 00361 

CLFILEDE 00363 
CLPILEDE 00364 
CLFILEDE 00365 

CLFILEDE 00368 
CLFILEDE 00369 
CLFILEDE 00370 


CLFILEDE 00373 

CLFILEDE 00375 
CLFILEDE 00376 
CLFILEDE 00377 

CLFILEDE 00380 
CLPILEDE 00381 


CLFILEDE 00384 

CLFILEDE 00386 
CLFILEDE 00387 
CLFILEDE 00388 

CLFILEDE 00391 

CLFILEDE 00393 


CLFILEDE 00396 

CLFILEDE 00398 
CLFILEDE 00399 
CLFILEDE 70400 

CLFILEDE 00403 
CLFILEDE 00404 
CLFILEDE 00405 
CLFILEDE 00406 
CLFILEDE 00409 


Exaaple 3 

5”FILEDEF | PRINTOUT TERMINAL (OPCASE NOC8ANCE \ 

i-- ----i 

Actio n: If a file definition with the ddnaie PRINTOUT does 
not ezi3t, one is established. Output written to PRINTOUT 
is typed at the terainal in uppercase. 


Exaaple 4 

i-•» 

| FILEDEF j DISK. DISK NAME OLDFILE ! 

A cti on: When I/O is done to a file with a cdnaae of DISK, 
the I/O is done on a disk file with a file identifier cf 
NAME OLDFILE. 


Exaaple 5 


I 

-i 


i--- - - 

| PILEDEF | 05 CLEAR 


Acti on: Any existing file definition fcr FIC5F001 is 
resowed. 


Exaaple 6 


| FILEDEF | SYSPUNCH DUMMY ] 

«----- 1 


Acti on: When any I/O coaaand is issued to a disk file with a 
ddnaae of DISKFILE, the real I/O operation is not perforaed. 


Exaaple 7 ■ 

| FILEDEF | NEWMAST TAP2 (9TRACK DEN 1600 E1CPM FB LPECL C5C ELCCK 31 


ictioa: I/O coaaands issued to a file with ddnaae of NEluMAST 
are directed to the tape located at logical unit TAP2. The 
tape is nine-track, and recording is done at 16CC fcpi. The 
tape is in fixed-block foraat with a logicel record length 
of 50 and a physical blocksize of 3COO. 
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CLFILEDE 


CLFILEDE 

CLFILEDE 

LFILEDE 

LFILEDE 

LFILEDE 

LFILEDE 

LFILEDE 


LFILEDE 

LFILEDE 

LFORMAT 


00411 Responses 


00416 
00417 
004 18 
00419 
00420 


ddnaael 


ddnaaeN 


detrice 1 [filenaael filetypel] 

detriceN [ filenaneN filetypeN] 


00424 A list of current definitions is typed if the FILEDEF 
00425 coaaand is entered with no operands. 


00428 DMKFLD704I INVALID CLEAR REQUEST 

00430 The FILE definition for which a CLEAR request was entered 
00001 does not exist; no action is taken. 
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CLFORNAT 

00004 

Z2MA1 


CLFORNAT 

00008 

The FOSNAT conaand is used to: 

CLFORNAT 

CLFORNAT 

CLFORNAT 

CLFORNAT 

00011 

00013 

00015 

00017 

1. Initialize a minidisk area in the CSS feraat. 

2. Count the number of cylinders on a ainidisk. 

3. Write a label on a ainidisk. 

4. Reset the nuaber of cylinders on the ainidisk. 

CLFORNAT 

CLFORNAT 

00020 

00029 

This command aay be used with a virtual 333C, 2314, or 2319 
direct access storage device. 

CLFORNAT 

CLFORNAT 

CLFORNAT 

00031 

00032 

00033 



1 -- » 

| FORMAT | ecu mode [Q'cyl] [ (RECOUP) | (LABEI) ] | 

i j 



CLFORNAT 

CLPORHAT 

00040 

00041 

ecu 

specifies the virtual device address cf the ainidisk 
to be foraatted. 

CLFORNAT 

CLFORNAT 

CLFORNAT 

00043 

00044 

00046 

aode 

specifies the aode letter to be related to the 
specified device address. Valid nodes ace A, B, C, 
D, E, F, G s I and Z. This field Bust be specified. 

CLFORNAT 

CLFORNAT 

CLFORNAT 

00049 

00049 

00050 

n'cyl 

specifies the number of cylinders which are to be 
available for use. If not specified, all cylinders 
are available. 


CLFORNAT 00054 
CLFORNAT 00059 
CLFORNAT 00060 
CLFORNAT 00060 
CLFORNAT 00061 
CLFORNAT 00061 
CLFORNAT 00062 


LABEL specifies that a label is to be written on the 
L disk and no foraatting is to take place. This causes 

a six-character label to be written cn cylinder 0, 
track 0, record 3 of the virtual disk or ainidisk. 
The user will be asked for a six-character disk 
label (less than six is left-jrstified, blank 
padded). 


CLFORNAT 00065 
CLFORNAT 00069 
CLFORNAT 00069 
CLFORNAT 00070 
CLFORNAT 00071 


RECONP specifies that the number of cylinders cn the disk 
B which are available to the user is fc be changed. 

N'cyl indicates the new size of available space. If 
n'cyl is not specified, ail cylinders are to be 
used. 


CLFORNAT 00073 
CLFORNAT 00074 
CLFORNAT 00075 
CLFORNAT 00076 
CLFORNAT 00077 


Note: If neither RECOMP nor LABEL is specified, the user's 
disk area is initialized by writing a device-dependent 
nuaber of records containing binary zeros cn each track. 
Any previous data on the disk is erased. A read after write 
check is aade as the disk is foraatted. 
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CLFORHAT 03080 Example 1 

CLFORMAT 00082 ,-— —n 

CLPORHAT 00083 | FOBMAT 1 191 A 25 I 

CLFORMAT 00084 --■» 

CLFORMAT 00087 Actio n: 25 cylinders of the dish located at virtual address 

CLFORH AT 00089 191 are to be initialized in CMS foriat. 


CLFORHAT 00092 Exaaple 2 

CLFORHAT 00094 , ---1 

CLFORHAT 00095 j FOBMAT | 192 B 25 (BBCOHP) | 

CLFORHAT OO096 •-•* 

CLFORHAT 00099 Acti on: The aaount of dish space available tc the user on 
CLFORHAT 00100 the dish located at virtual address 192 is to be changed to 

CLFORHAT ooiOl 25 cylinders. 


CLFORHAT 00104 Exaaple 3 

CLFORHAT 00106 ,--1 

CLFORHAT 00107 | PORHAT | 193 C (LABEL) | 

CLPORHAT 00108 «-■* 

CLFORHAT 00111 Acti on: A label is to be written cn the dish at virtual 

CLPORHAT ^0112 address 193. The user will be requested tc enter a 

CLFORHAT 00114 six-character label. 


CLPORHAT 00116 Resp o nses 


CLPORHAT 00120 DHSFHT603R FORMAT HILL ERASE ALL FILES ON DISK 'iode (ecu)* 
CLFORHAT ^0122 DO YOU WISH TO CONTINUE? 

CLFORHAT 00125 The user has indicated that a dish area is tc be initialized 
CLFORHAT 00126 which iaplies that any existing files will be erased. This 
CLFORHAT 00127 aessage gives hia the option of cancelling the execution cf 
CLFORHAT 00128 the FOBHAT coaaand. He should reply YES or NO. 


CLFORHAT 00130 DMSFHT705I DISK REMAINS UNCHANGED 

CLFORHAT 00132 The user replied * NO* to the above aessage. 


CLPORHAT 03135 DMSFMT605B ENTER DISK LABEL: 

CLFORHAT 00136 The user has requested that a label is to be written on the 

CLFORHAT 00138 dish. He should enter a 1-6 character, label. 
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CLFOaH AT 

CLFORMAT 

CLFOBMAT 


CLFORNAT 

CLFOBM AT 
CLFORNAT 


CLFORMAT 
CLFORM AT 

CLPORMAT 
CLGENDIB 


00140 


DBSFMT732I 'ana* CYL FORMATTED ON DISK 'node (ecu)' 


00142 

00143 


A formatting operation ahs been done on nnn cylinders of the 
disk at virtual address ecu. 


00145 


DHSFHT733I FOBMATTING DISK 'mode' 


nO 146 
00147 


The disk represented by mode letter 'icde' is being 
formatted. 


00151 

00152 

00154 

00001 


DISK 'mode (ecu).': »n« FILES, 'o' BLOCKS , "n" LEfI (OF *n'), 
nnlt FULL ('n* CYL) 

This message gives the extent and other inferaatien about a 
disk when a BECOMP operation has been done. 
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CLGENDIB 00004 GENDJH 


JLGENDIS 00006 
CLGENDIB 00007 
CLGENDIR 00008 
CLGENDIR "0"09 
LGENOIR 00C10 
LGENOIR O0010 
LGENOIR 00011 


The G Elf DIRT command is for use in creating CBS commands m 
which the number of modules involved would increase the si 2 e 
of the resident directory significantly, and thus increase 
search tine and storage requirements. By using GENDIRT tc 
create an auxiliary directory, the file entries for the 
given command will be loaded only when the command is 
invoked. 


CLGENDIR 00018 
oigenoir 00019 
CLGENDIR "0020 


t GENDIBT 

i_ 


I directory-name 


'LGENOIR "9C25 
CLGENDIR "0026 


directory-name is the entry point of the auxiliary 
directory. 


CLGENDIB 00032 


Creation of. ka*klli&U. Cifiectoo 


CLGENDIR 00036 
CLGENDIR 00037 
CLGENDIR r '0038 


The auxiliary directory TEXT deck is obtained by assembling 
a set of DNSFST macros, one for each module name. The 
format of the DNSFST macro is as follows: 


CLGENDIR 00"41 


DNSFST module-name [ ,alias-name] 


:lgent)IR 00044 module-name 
CL GEN 0IR """45 
CLGEN0IR "0046 


indicates the name of the module whose 
File Status Table (FST) information is to 
be copied. 


CLGENDIR 00048 alias-name 
CLGENDIR 00049 


indicates another name by which the module 
is to be known. 


clgendir 00053 


An example is shown below for the VH/370 System Assembler. 


CLGENDIR "0"55 
CLGENDIR 00055 
CLGENDIR 00057 
CLGENDIR """59 
CLGENDIR "0059 
CLGENDIR "O^D 
CLGENDIR 00"61 
CLGENDIR "0"62 
CLGENDIR "0"61 
CLGENDIR "0064 
CLGENDIR 0""65 
Z LGENOIR 0""66 
CLGENDIR "0067 
CLGENDIR "0"68 


ASNDIRT START 0 

DC F '40' Length of FST entry 

DC A (DIRTEND-DIRTBEG) Size of directory 

DIRTBEG EQU . * 

DNSFST IEUASN 
DMSFST IEUMAC 
DNSFST IEUFI 
DNSFST IEUF2 
DNSFST IEUP3 
DNSFST IBURTA 
DNSFST IEUF7 
DNSFST IEUFI 
DMSFST IEUF8 
DNSFST IEUPPP 


142 



IBM CONFIDENTIAL 


CLGENDIR 00069 
CLGEJfDIB 00070 
CLGENDIH 00071 
CLGENDIB 00072 


DHSFST IBOEBB 

DC 2i(0) Pointer to next FST block 

DIBTEVD BQO * 

BID 
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CLGENHOD 00003 GEIHO D 

CLGENHOD 00005 The GENHOD command is used to generate absolute core-image 
CLGENHOD 00013 files. 


CLGENHOD 00015 
CLGENHOD 00016 
CLGENHOD 00017 
CLGENHOD 00018 
CLGENHOD 00019 
CLGENHOD 00020 
CLGENHOD 00021 
CLGENHOD 00022 
CLGENHOD 00023 


| GENBOD 1C fn 

[ft £ fa]]] 

[ (options...) ] 

— i 

1 G i 

I 1 

gE&jgags 

[ HA£|NOHAP ] 




[ FBOH entryl ] 


1 I 


C TO entry2 ] 




[ STKJNOSTB ] 


1 1 


£ SYSTEM ] 






CLGENHOD 00028 fn 
CLGENHOD 00029 
CLGENHOD 00030 
CLGENHOD 00031 


specifies the filename of the MODULE file being 
crested. If fn is not specified, the file 
crested sill have a filename equal tc that cf 
the first entry point in the LOAD HAP. 


CLGENHOD 00034 ft 
CLGENHOD 00036 


specifies the filetype of the MODULE file being 
created. Bast be BODOLB if specified. 


CLGENHOD 00039 fn 
CLGENHOD 00040 
CLGENHOD 00041 


specifies the filemode of the HODDLE file being 
created. If not specified, the file is written 
on the user's primary read-write disk. 


CLGBBHOD 00044 Options 

CLGENHOD 00045 If conflicting options are specified, the last cnc entered 
CLGENHOD 00046 will be used. 


CLGENHOD 00048 
CLGENHOD 00049 
CLGENHOD 00049 
CLGENHOD 00050 


FBOH entryl specifies an entry point or a control section 
name indicating the starting main storage 
location from which the core-iaage copy is to 
be generated. 


CLGENHOD 00053 
CLGENHOD 00054 
CLGENHOD 00054 
CLGENHOD 00055 


TO entry2 specifies an entry point or a control section 
name indicating the ending main storage lccaticn 
from which the core-iaage copy is to be 
generated. 


CLGBBHOD 00057 
CLGENHOD 00058 
CLGENHOD 00059 
CLGENHOD 00060 


Note : If 'FBOH' is not specified the module consists cf 

storage starting at the point of £n (or first loaded 
external name). If 'TO' is not specified the module 
consists of storage to the end of loaded code. 


CLGENHOD 00062 
CLGENHOD 00063 


specifies that a load map is tc be contained in 
the MODULE file. 
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CLGENNOD 

CLGENHOD 

CLGENHOD 

CLGENNOD 

CLGENNOD 

CLGENNOD 

CLGENHOD 

CLGENHOD 

CLGENHOD 

CLGENNOD 

CLGENNOD 

CLGENHOD 

CLGENHOD 

CLGENHOD 

CLGENNOD 

CLGENNOD 

CLGENHOD 

CLGENHOD 
CLGENHOD 
CLGENHOD 
CLGENHOD 
CLGENHOD 
CLGLOBAL 


00066 

00067 

NOfliP 


specifies that a load aap is not to te contained 
in the NODULE file. 

00070 

00071 

00072 

00073 

00074 

00075 

00076 

STB 


indicates that when the MODULE is subsequently 
loaded (see the CHS LOADHOD ccaaand) the CHS 
storage initialization routine is to be invoked. 
This routine frees any storage teaaining froa a 
previous progran. STB is the default setting if 
the HODOLE is to be loaded at the beginning cf 
user available storage. 

00078 

00079 

00080 

00081 

00082 

NOSTB 


indicates that, when the MODULE is leaded, free 
storage does not reset any storage currently in 
use. NOSTB is the default setting if the MODULE 
is to be loaded at a location other than the 
default load address. 

00084 

00085 

00086 

SYSTEH 


indicates that when the NODULE is subsequently 
loaded, it is to have a storage protect key of 
zero. 

00089 

00090 

0009! 

00092 

00093 

00001 

Note: Before the file is written, undefined s ynbcls are set 
to location zero and the conaon reference ccctrcl section is 
initialized. The undefined synbols are not retained in the 
HODOLE file as being unresolved; therefore, once the MODULE 
is generated, those references cannot be resclved and lay 
cause unpredictable results during execution. 
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CLGLOBAL 00012 GLOBAL 


CLGL08AL 00014 
CLGLOBAL 00015 
CLGLOBAL 00016 
CLGLOBAL 00016 
CLGLOBAL 00017 
CLGLOBAL ^0018 
CLGLOBAL 00018 
CLGLOBAL 00019 
CLGLOBAL 00020 


The GLOBAL command is used to specify CMS libraries to be 
searched when processing subsequent CMS commands. The 
GLOBAL coaaand reaains in effect for an entire CMS session 
unless it is explicitly cancelled or until ancther GLOBAL 
conaand is entered. There are no default libraries, so the 
coaaand aust be entered if any libraries are to be used. 
The GLOBAL coaaand will verify the existence of the 
libraries and issue an error nessage if a specified library 
does not exist. 


CLGLOBAL 00022 ,-t 

CLGLOBAL "0^23 | GLOBAL | ( MACLIB } [libnaae...] I 
CLGLOBAL 00024 | GL J { TXTLIB } | 
CLGLOBAL 00^25 «-J 


CLGLOBAL 00032 MACLIB 
CLGLOBAL 00033 
CLGLOBAL 00033 
CLGLOBAL 00035 


the MACLIB fora of the GLOBAL ccaaand allows 
the user to specify the aacrc libraries that 
are to be used during the execution cf 
language processor coaaands. 


CLGLOBAL 00038 TXTLIB 
CLGLOBAL 00039 
CLGLOBAL 00040 
CLGLOBAL 00040 
CLGLOBAL 00040 
CLGLOBAL 00041 


The TXTLIB fora of the GLOBAI coaaand allows 
the user to specify text libraries to be 
searched for aissing subroutines when the 
LOAD or INCLUDE coaaand is issued or when a 
dynaaic load occurs (that is, OS SVC 8 is 
issued) . 


CLGLOBAL 00044 
CLGLOBAL 00045 
CLGLOBAL 00046 
CLGLOBAL 00046 
CLGLOBAL 00047 
CLGLOBAL 00047 
CLGLOBAL 00048 
CLGLOBAL 00048 
CLGLOBAL 00049 
CLGLOBAL 00049 
CLGLOBAL 00049 
CLGLOBAL 00050 


libnaae 


specifies the filenaaes of up to eight 
libraries. If the MACLIB feta cf the GLOBAL 
coaaand is being used, the filetypes of all 
files specified oust be MACLIB. If the 
TXTLIB fora of the coaaand is being used, the 
filetypes of all files specified aust be 
TXTLIB. The libraries are searched in the 
order in which they are naaed. If no library 
naaes are specified, the coaaand is used to 
cancel the effect of any previous GLOBAL 
coaaand of the specified fera (that is, 
MACLIB or TXTLIB) . 


CLGLOBAL 00053 


Exaaple 1 


CLGLOBAL 00055 
CLGLOBAL 00056 
CLGLOBAL 00057 


r -- - ———.— - 

| GLOBAL | MACLIB ACCESS SISMAC 

j .... . 



CLGLOBAL 00061 
CLGLOBAL 00062 


The system searches files ACCESS MACLIB and SYSMAC 
MACLIB for aissing nacros during coapilationa. 
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CLGLOBAL 

CLGLOBAL 

CLGLOBAL 

CLGLOBAL 

CLGLOBAL 

CLGLOBAL 

CLGLOBAL 


CLGLOBAL 

CLGLOBAL 

CLGLOBAL 

CLGLOBAL 

CLGLOBAL 

CLINCLOD 


00065 

00067 

00068 

00069 

Exaaple 2 



1 GLOBAL | TXT LIB CONVERT FLOAT 

1 

1 





00072 

00073 

00074 

Action: The systea searches Tiles CONVERT TXTLIB 
TXTLIB for aissing subroutines during subseguent 
IICLODE coanands. 

and FLOA1 
LOAD and 

00076 

00078 

00079 

00080 

Exaaple 3 



| GLOBAL | MACLIB 

1 

1 

- l 





00084 

00002 

Action: Cancels the effect of 
libaaae coaaand. 

any previous GLCEAL MACLIB 
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CLI1CLUD 00006 IN Cl, ODE 


CLINCLtJD 00008 
CLINCLOD 00009 
CLINCLOD 00010 
CLIHCLUD 00010 
CLINCLOD 00011 
CLINCLOD 00011 
CLINCLOD 00013 


The INCLODE coaaand reads froa disk one or sore TEXT files 
containing relocatable object code and leads then intc 
storage, establishing the proper linkages betaeen the files. 
INCLODE is noraally used to resolve references left 
unresolved b j a previous LOAD or INCLUDE coaaand. A LOAD 
coaaand aust have been previously issued lor the INCLODE 
coaaand to produce desirable results. 
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CLINCLOD 00027 
CLINCLOD 00028 
CLINCLOD 00029 
CLINCLOD 00030 
CLINCLOD 00031 
CLINCLOD 00032 
CLINCLOD 00033 
CLINCLOD 00034 
CLINCLOD 00035 
CLINCLOD 00036 
CLINCLOD 00037 
CLINCLOD 00038 
CLINCLOD 00039 
CLINCLOD 00040 
CLINCLOD 00041 
CLINCLOD 00042 
CLINCLOD 00043 
CLXNCLUD 00044 
CLINCLOD 00045 
CLINCLOD 00046 
CLINCLOD 00047 
CLINCLOD 00048 
CLINCLOD 00049 
CLINCLOD 00050 
CLINCLOD 00051 
CLINCLOD 00052 
CLINCLOD 00053 
CLINCLOD 00054 
CLINCLOD 00055 
CLINCLOD 00056 
CLINCLOD 00057 
CLINCLOD 00058 
CLINCLOD 00059 
CLINCLOD 00060 
CLINCLOD 00061 
CLINCLOD 00062 
CLINCLOD 00063 
CLINCLOD 00064 
CLINCLOD 00065 
CLINCLOD 00066 
CLINCLOD 00067 
CLINCLOD 00068 
CLINCLOD 00069 
CLINCLOD 00070 

CLINCLOD 00076 
CLINCLOD 00076 
CLINCLOD 00077 
CLINCLOD 00077 
CLINCLOD 00078 

CLINCLOD 00081 Opti ons 

CLINCLOD 00082 If options have been specified with a previous LCAD ct 
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CLINCLOD 00083 
CLINCLOD 00083 
CLINCLOD 00084 
CLINCLOD 00085 
CLINCLOD 00086 


IHCLODE coaaand, these options (with the exception of CLEAB 
and OBIOIN) reaain set if SAME is specified when INCLUDE is 
issued. Otherwise. the options assuae their default 
settings.. If conflicting options are specified, the last cne 
entered will be in effect. 


CLINCLOD 00088 CLEAB 
CLINCLOD 00088 
CLINCLOD 00089 


specifies that the load area in storage is to 
be cleared to binary zeros before the files 
are loaded. 


CLINCLOD 00092 BOCLE AB 


does not clear the load area before leading. 


CLINCLOD 00095 
CLINCLOD 00098 
CLINCLOD 00099 
CLINCLOD 00099 
CLINCLOD 00100 
CLINCLOD 00101 
CLINCLOD 00101 
CLINCLOD 00102 
CLINCLOD 00103 


BESET (entry) resets the current execution starting point 
{ * ) that had been set by a previous LOAD cr 

INCLODE coanand. If 'entry' is specified, the 
starting execution address is reset to the 
specified location. If an asterisk is 
specified, the starting point is reset to the 
location of the first file ox to the address 
specified as an operand of ax END card, LDT 
card, or ENTBY card. 


CLINCLOD 00105 
CLINCLOD 00105 
CLINCLOD 00107 
CLINCLOD 00107 
CLINCLOD 00108 
CLINCLOD 00109 
CLINCLOD 00109 
CLINCLOD 00111 


OBIGIN hexloc specifies that the loading of the progran is 
to begin at hexadeciaal loeatien "hexloc". If 
this option is not specified, leading will 
begin at the next available storage location. 
INCLODE does not overlay any previously leaded 
files unless this option is specified and the 
address given indicates a loeatien within a 
previously loaded object aodule. 


CLINCLOD 00113 flJJ> 
CLINCLOD 00114 


specifies that inforaation is tc be added to 
the LOAD HAP file. 


CLINCLOD 00116 NOHAP 
CLINCLOD 00117 


does not add any inforaation to the LOAD HAP 
file. 


CLINCLOD 00119 TYPE 
CLINCLOD 00120 
CLINCLOD 00120 
CLINCLOD 00121 
CLINCLOD 00122 


specifies that the LOAD HAP cf the files 
loaded is to be typed at the terainal, in 
addition to being written onto the user's 
priaary disk. This option is valid only if HAP 
is specified or iaplied. 


CLINCLOD 00124 
CLINCLOD 00125 


does not type the LOAD HAf file at the 
terainal. 


CLINCLOD 00128 


prints invalid card iaages in the LCAE HAP. 


CLINCLOD 00130 NOINY 
CLINCLOD 00131 


suppresses the inclusion of invalid card 
iaages in the LOAD HAP. 


CLINCLOD 00133 £££ 

CLINCLOD 00134 


prints Beplace card iaages in the LOAD HAP. 
See the explanation of the LOAD ccaaand for a 
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CLINCLUD 

0 0135 


CLINCLUD 

01137 

NO REP 

CLINCLUD 

00138 


CLINCLUD 

00140 

AUTO 

CLINCLUD 

00140 


CLINCLUD 

00141 


CLINCLUD 

00144 

NOAUTO 

CLINCLUD 

00146 

USE 

CLINCLUD 

00147 


CLINCLUD 

00148 


CLINCLUD 

0 0150 

NOLI BE 

CLINCLUD 

00151 


CLINCLUD 

00153 

START 

CLINCLUD 

00154 


CLINCLUD 

00156 

SAHE 

CLINCLUD 

"0157 


CLINCLUD 

00157 


CLINCLUD 

00157 


CLINCLUD 

00159 


CLINCLUD 

00159 


CLINCLUD 

00160 


CLINCLUD 

00161 


CLINCLUD 

00166 

112£§: 1 

CLINCLUD 

00176 

r~ 

CLINCLUD 

00177 

1 

CLINCLUD 

00178 

1 

CLINCLUD 

"0179 

1 

CLINCLUD 

00180 

1 

CLINCLUD 

"0181 


CLINCLUD 

00182 


CLINCLUD 

00183 


CLINCLUD 

""184 


CLINCLUD 

00185 


CLINCLUD 

0 0186 


CLINCLUD 

""187 


CLINCLUD 

00188 


CLINCLUD 

"0189 


CLINCLUD 

00190 


CLINCLUD 

"0191 


CLINCLUD 

"0192 


CLINCLUD 

00193 


CLINCLUD 

00194 



description of the SEP card, 

suppresses the printing of Replace card images 
in the LOAD HAP. 

specifies that user disks are tc fce searched 
for TEXT files to resclve undefined 
references. 

suppresses automatic searching for TEXT files. 

specifies that TXTLIB files which have teen 
activated by the GLOBAL command are to be 
searched for missing subroutines. 


does not search any 
unresolved references. 


loading has completed. 


and CLEAR) that were used 
INCLUDE or LOAD command are 
effect. Otherwise, the defa 
unspecified options is ass 


Example 2. 


112£§: ISS2iUti2a °£ fiSlSESBCSS 


LIB 

files 

f cr 

tc 

begin 

after 

s <e 

icep t 

ORIGIN 

by 

a previous 

tc 

re aa 

in in 

ult 

setting of 

used 

. If 

other 

SAME 

, they 

will 

cpticcs. 

See 


102 E: 


IN FINAL PUBLICATION THIS 
WILL BE REDRAWN AS REuUlR 


I 

i unresolved 
| references 

I ? 

a. .-■ •- 

I 

i yes 

I 


i 

I 

I_*£_ search complete 

I 
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CLIHCLDD 

CLINCLOD 

CLINCLOD 

CLIHCLDD 

CLIMCLUD 

CLINCLOD 

CLINCLOD 

CLINCLOD 

CLIHCLDD 

CLINCLOD 

CLINCLUD 

CLIHCLDD 

CLIHCLDD 

CLIHCLDD 

CLIHCLDD 

CLIHCLDD 

CLINCLOD 

CLIHCLDD 

CLIHCLDD 

CLINCLOD 

CLINCLOD 

CLIHCLDD 

CLINCLOD 

CLINCLOD 

CLIHCLDD 

CLIHCLDD 

CLINCLOD 

CLINCLOD 

CLIHCLDD 

CLIHCLDD 

CLIHCLDD 

CLINCLOD 

CLIHCLDD 

CLINCLOD 

CLIHCLDD 

CLIHCLDD 

CLINCLOD 

CLINCLOD 

CLINCLOD 

CLINCLOD 

CLINCLOD 


CLINCLOD 

CLINCLOD 

CLINCLOD 

CLINCLOD 

CLINCLOD 

CLIHCLDD 

CLIHCLDD 

CLINCLOD 
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00195 

00196 

00197 

00198 

00199 

00200 

00201 

00202 

00203 

00204 

00205 

00206 

00207 

00208 

00209 

00210 

00211 

00212 

00213 

00214 

00215 

00216 

00217 

00218 

00219 

00220 

00221 

00222 

00223 

00224 

00225 

00226 

00227 

00228 

00229 

00230 

00231 

00232 

00233 

00234 

00235 

00236 


| HOAUTO |. 

t SPECIFIED | 

I 1 I 

i_ J 

I 

| HO 


. 122 . 


Ose standard order of j 
search to locate files I 
with a filetype of TEXT | 
and a filename correspond-) 
ing to the unresolved j 
reference, I 


I 

l<- 

I 


| unresolved 
j references 

1 * 

• _ 


ftp search coaplete 


I 

| IBS 
I 


| HOLIBE 
| specified 




IBS search coaplete 


I 

| NO 
I 


Search active TXTLIB files (those 
which have been previously 
specified by a GLOBAL coaaand.) 
Files are searched in the order 
they were entered in the coaaand. 


I 

search terainated 


00240 Example 1 

00242 ,- t 

00243 | INCLODB.I MAIN SDBI DATA (BESET HAIM NAP SIAHT) | 

00244 »-- •» 

00247 Acti on: The files naaed HAIM TEXT, SDBI TEXT, and LATA TEXT 

00248 are brought into aain storage and appended to files which 

00249 were previously loaded. Inforaation about loaded files is 

00250 added to the LOAD HAP file* Execution sill begin at Entry 
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CLINCLOD 00251 point MAIN. 


CLINCLOD 00253 Exaaple 2 

CLINCLOD 00255 i- t 

CLINCLOD 00256 | LOAD | BAIN (IOBAP NOLIBB NOBEP) | 

CLINCLOD 00257 «- ■* 


CLINCLOD 00259 
CLINCLOD 00260 
CLINCLOD 00261 



CLINCLOD 00265 Action : During execution of the LOAD coaaand, the file naacd 
CLINCLOD 00266 BAIN TEXT is brought into Bain storage* The following 
CLINCLOD 00266 options are in effect: NOBAP, MOLIBE, NOBEE, NOTYPE, INV, 
CLINCLOD 00267 AUTO. During execution of the INCLUDE coiaand, the file 
CLINCLOD 00268 naaed SUBI TEXT is appended to BAIN TEXT. The following 
CLINCLOD 00269 options are in effect: 

CLINCLOD 00271 BAP, NOLIBB, NOBEP, NOTIPE, INV, AUTO 

CLINCLUD 00273 Hate: After IPLing CBS, at least one LOAD ccaaand mEt have 
CLINCLOD 00273 been issued before INCLUDE can be used with predictable 
CLINCLOD 00274 results. 


CLINCLUD 00279 Besponses 


CLINCLUD 00281 EXECUTION BEGINS... 

CLINCLOD 00282 STABT has been specified with INCLUDE and the loaded prograa 
CLINCLOD 00283 has begun execution. Any further responses are iron the 
CLINCLOD 00284 prograa. 


CLINCLOD 00286 INVALID CABD - XXX...XXX 

CLINCLOD 00287 INV has been specified with LOAD and an icvalid card has 
CLINCLOD 00288 been found. The aessage and the contents of the invalid 
CLINCLOD 00288 card (xxx.,.xxx) are only listed in the file LOAD BAP. The 
CLINCLOD 00290 invalid card is ignored and loading continues. 


CLINCLOD 00292 COHTBOL CABD - ... 

CLINCLOD 00293 A loader or library-search control card has been 
CLINCLUD 00294 encountered, (that is, BNTBY or LIBBABY). See the 
CLINCLOD 00294 description of the LOAD coaaand for the use of ENTBB and 
CLINCLOD 00295 LIBBABY control cards. This response is placed in the LOAD 
CLLISTF 00001 BAP only. 
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CLLISTF 00004 LI STFILB 


CLLISTF 00012 
CLLISTF 00012 
CLLISTF 00013 
CLLISTP 00014 
CLLISTF 00014 
CLLISTF 00015 
CLLISTF 00016 


The LISTFILB coanand is used to obtain specified information 
about the user's CHS files residing on accessible, user 
disks* The information may either be typed at the terninal 
or used to create a special EXEC file on disk. All operands 
are optional; if no operands are specified, a list of 
default infornation about each file on the user's disks is 
typed at the terninal. 


CLLISTF 00026 ,---- t 

CLLISTF 00027 | LISTFILB | ££fn £ f t £fn]j] [ (options)]] | 

CLLISTF 00028 | L | I 

CLLISTF 00029 | | opti ons: [ UOHEADER ] | 

CLLISTF 00030 | | £ EXEC|APESND] | 

CLLISTF 00031 | | [ FNAHEJFTYPE|£H2££IFCBHAT|ALLOC|DATE|LABEL ] | 

CLLISTF 00032 *• -- --— - J 


CLLISTF 00037 fn 
CLLISTF 00038 
CLLISTF 00040 


specifies the filenane of the files for which 
infornation is to be collected. If an asterisk is 
coded in this field, all filenaaes will be used. 


CLLISTF 00042 ft 
CLLISTF 00043 
CLLISTF 00045 


specifies the filetype of the files for which 
infornation is to be collected. ‘If an asterisk is 
coded in this field, all filetypes will be used. 


CLLISTF 00047 fn 
CLLISTF 00048 
CLLISTF 00049 
CLLISTF 00050 


specifies the filenode of the files for which 
infornation is to be collected. If this field is 
oaitted, the prinary disk will be searched, if an 
asterisk is coded all disks will be searched. 


CLLISTF 00052 
CLLISTF 00053 
CLLISTF 00054 
CLLISTP 00054 
CLLISTF 00056 


Mote : An asterisk (*), immediately preceded by any nunber of 
characters for fn or ft, searches for the specified 
characters as the leading characters for that identifier. 
For exanple, LISTFILB ABC* ASSEMBLE prints the identifiers 
for all ASSBHBLB files with filenaaes beginning with ABC. 


CLLISTF 00059 Outpu t; Format Options 


CLLISTF 00061 
CLLISTF 00064 
CLLISTF 00065 


HEADER specifies that column headings are to be included 

H in the listing. HEADER is the default. The fornat 

of the heading is: 


CLLISTF 00067 FNAHE FTTPE FNODE FORMAT SECS BLKS EA1E TIME LABEL 

CLLISTF 00070 MOHEADER specifies that coluan headings are net to be 

CLLISTF 00072 NOH included in the list. 
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CLLISTF 

00076 

CLLISTF 

00078 

CLLISTF 

00082 

CLLISTF 

00082 

CLLISTF 

00083 

CLLISTP 

00084 

CLLISTF 

00085 

CLLISTF 

00086 

CLLISTP 

00087 

CLLISTP 

00088 

CLLISTF 

00089 

CLLISTF 

00090 

CLLISTP 

00091 

CLLISTF 

00092 

CLLISTF 

00092 

CLLISTF 

00093 

CLLISTP 

00093 

CLLISTF 

00095 

CLLISTP 

00098 

CLLISTP 

00101 

CLLISTP 

00102 

CLLISTF 

00103 

CLLISTP 

00104 

CLLISTF 

00105 

CLLISTF 

00106 

CLLISTF 

00110 

CLLISTP 

00112 

CLLISTF 

00113 

CLLISTP 

00114 

CLLISTF 

00115 

CLLISTP 

00116 

CLLISTF 

00121 

CLLISTP 

00124 

CLLISTF 

00127 

CLLISTF 

00130 

CLLISTP 

00133 

CLLISTF 

00136 

CLLISTF 

00139 

CLLISTF 

00142 

CLLISTF 

00144 

CLLISTF 

00146 

CLLISTF 

00148 

CLLISTF 

00151 


Oatcai 


QptiOQS 


EZ8C indicates that a file of 80-character records (one 

E * record for each of the files which satisfies the 

given fileid) is to be created cn the user's 

priaary disk. The file naae is CHS EXEC A1. If a 
file with this naae already exists# the existing 
one is erased and a new one is created (unless the 
APPEND option is ‘specified# in which case the 
existing file is retained and the new entries are 
appended to it). The EXEC procedure thus created 
contains two syabolic variables# 61 and 62. The 
aain purpose of the CHS EXEC file created via this 
option is to be used with the EXEC coaaand# but it 
can be processed as any other file (that is# 

printed# typed# edited# added' to# changed# and so 
forth). "Appendix E: Saaple Terainal Session" 
shows an exaaple of the use of a CHS EXEC file 
created in this wanner. 

APPEND The EXEC list created is tc be appended to the 

AP existing CHS EXEC At file. If the EXEC cption is 

specified instead of this cne# any existing CHS 

EXEC file is erased and replaced try the cne 
created by this LISTFILE connand. If this opticn 
is specified and no CHS EXEC file exists# cne will 
be created. 


lafarialigp gesusst agtjflag 

Mote: Only one of these options need be specified. If one 
is specified# any options with a higher priority will also 
be in effect. If none of the followicg options are 

specified# the default inf ornation reguest options noted 
below are in effect. 

Default Inforaation Bequest Options 

PNAHE specifies that the list is tc contain only 

FN filenaaes. Option priority is 7. 

FTIPE specifies that the list created is tc contain only 

FT filenaaes and filetypes. Option priority is 6. 

FHODE specifies that the list will contain filenaaes# 

FH filetypes# and fileaodes. Option priority is 5. 

Suppleaental Inforaation Options 

FOBHAT specifies that the list is to contain the record 

FO foraat and logical record length of the largest 

record of each file. Option priority is 4. 

ALLOC specifies that the list is to include the aaount 
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CLLISTF 

00153 

CLLISTF 

00154 

CLLISTF 

00155 

CLLISTF 

00157 

CLLISTF 

00160 

CLLISTF 

00163 

CLLISTF 

00164 

CLLISTF 

00168 

CLLISTF 

00172 

CLLISTF 

00175 

CLLISTF 

00178 

CLLISTF 

00179 


CLLISTF 

00182 

CLLISTF 

00189 

CLLISTF 

00190 

CLLISTF 

00191 

CLLISTF 

00192 

CLLISTF 

00197 

CLLISTF 

00199 

CLLISTF 

00201 

CLLISTF 

00201 

CLLISTF 

00203 

CLLISTF 

00205 

CLLISTF 

00207 

CLLISTF 

00208 

CLLISTF 

00209 

CLLISTF 

00210 

CLLISTF 

00212 

CLLISTF 

00213 

CLLISTF 

00214 

CLLISTF 

00217 

CLLISTF 

00218 

CLLISTF 

00220 

CLLISTF 

00224 


of disk space that CHS has allocated to the 
specified file. The quantities given ace the 
nuabec of 800-byte blocks and the nunbec of' 
logical cecocds in the file. Optioc priority is 3. 

specifies that the date the file «as last eritten 
is to be included in the list. The foca of the 
date is: 

■on th/day/year houc:ainute 
Option priority is 2. 

specifies that the label of the disk on which the 
file resides is to be included in the list. Option 
priority is 1» 


i - 1 

| LISTFILE * ASSEMBLE * (LABEL) i 

I I 

t_;_____J 


Action ; LABEL is the lowest priority option; therefore, all 
other options are also in effect. This ccaaand requests that 
all inforaation about the files with a filetype of ASSEMBLE 
is to be typed at the terainal. The header will be typed 
since LABEL is a supplemental inforaation option. 

The following will type at the terainal: 

FKAHB FTYPB FMODE FOBHAT BECS BLKS DATE TIME 

r i 
I F| 

fn ASSEMBLE fa |V| Irecl norecs noblke aa/dd/yy hh:aa 

• 8. J 


One entry will type for each file with a filetype of 

ASSEMBLE. 

where: 

fn is the filenaae of the file. 


AL 


DATE 

D 


LABEL 

L 


S&diela 


CLLISTF 00227 ASSEMBLE is the filetype specified in the ccaaand. 

CLLISTF 00230 fa is the fileaode of the file 


156 


LABEL 

▼ olid 



IB9 CONFIDENTIAL 


CLLISTF 

CLLISTP 

CLLISTF 

CLLISTF 

00234 

00236 

00238 

00240 

r i 

1 P1 

m 

L J 

is the file foraat: F - (fixed length) 

V - (variable length) 


CLLISTF 

CLLISTF 

00242 

00243 

Irecl 

is the logical record length of the 
in the file. 

largest record 

CLLISTF 

00246 

norecs 

is the nuaber of logical records in 

the file. 


CLLISTF 

CLLISTF 

00248 

00249 

noblks 

is the nnaber of physical blocks 
occupies on disk. 

that the 

file 

CLLISTF 

CLLISTF 

00251 

00252 

■■/dd/n 

is the date (aontk/day/jear) that 
created. 

the file 

was 

CLLISTP 

CLLISTF 

00254 

00255 

hh:aa 

is the tiae (hours:ainutes) that 
created. 

the file 

was 

CLLISTF 

CLLISTF 

00257 

00258 

▼olid 

is the voluae serial nuaber of the ainidisk 
which the file resides. 

cn 


CLLISTF 

00263 

Heap oases 





CLLISTF 

00266 

If the BXBC 

option 

is 

not specified, 

the requested 

CLLOAD 

00001 

inforaation is 

typed at 

the 

terainal. 
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CLLOAD 0000% 


CLLOAD 00005 
CLLOAD 00006 
CLLOAD 00008 


The LOAD coiaand nads fro* disk on* or toe* TEXT files 
containing relocatable object code and loads the* into aain 
storage, establishing the proper linkages between the files. 


CLLOAD 

00020 

i- 






—1 

CLLOAD 

00021 

1 

LOAD I 

f n . * , . 

£ (options) j 




CLLOAD 

00022 

1 







CLLOAD 

00023 

1 



options: 

r i 



CLLOAD 

0002% 

1 




| CLEAR | 



CLLOAD 

00025 

1 




U&CU11I 



CLLOAD 

00026 

1 

1 



L J 



CLLOAD 

00027 


1 



r t 



CLLOAD 

00028 

1 

1 



IRBSET (entry) | 



CLLOAD 

00029 

1 

1 



1 I * > 1 



CLLOAD 

00030 

1 

9 



L J 



CLLOAD 

00031 

1 




r 

7 


CLLOAD 

00032 

1 




(ORIGIN (hexloc 

} 9 


CLLOAD 

00033 

1 

1 



| (TRANS 

} 1 


CLLOAD 

00034 


1 



4. 

j 


CLLOAD 

00035 





r i 



CLLOAD 

00036 

1 




IM£ t 



CLLOAD 

00037 

1 

1 



|NOHAPi 



CLLOAD 

00038 

» 

1 



L J 



CLLOAD 

00039 

1 

I 



r i 



CLLOAD 

00040 

1 

1 



| TYPE | 



CLLOAD 

00041 

1 

1 



IBQIIEfil 



CLLOAD 

00042 

1 




i j 



CLLOAD 

00043 

1 




r i 



CLLOAD 

0004% 

1 

1 



IIM l 



CLLOAD 

00045 

1 

1 



|NOINf | 



CLLOAD 

00046 

1 

1 



L J 



CLLOAD 

00047 

1 

1 



r 7 



CLLOAD 

00048 

1 

1 



ll££ | 



CLLOAD 

00049 

1 

1 



| HO EBPj 



CLLOAD 

00050 

1 

1 



i J 



CLLOAD 

00051 

1 

1 



r *i 



CLLOAD 

00052 

1 




1AU12 1 



CLLOAD 

00053 

f 




| NOAUTO | 



CLLOAD 

00054 

1 

t 



i j 



CLLOAD 

00055 

1 




r 7 



CLLOAD 

00056 

1 

i 



1 LIM£ ! 



CLLOAD 

00057 

1 




| NOLIBE | 



CLLOAD 

00058 

1 

i 



i J 



CLLOAD 

00059 

1 

i 



[ START ] 



CLLOAD 

00060 

a_ 






_ j 


CLLOAD . 00067 fn 

CLLOAD 00068 
CLLOAD 00069 
CLLOAD 00070 


specifies the naaes of the files to be loaded into 
storage. Files aust have a filetype of TEXT and 
consist of relocatable object code such as that 
produced by the language processors. 
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CLLOAD 

00075 

0£&i£&S 



CLLOAD 

00076 

If conflicting options ace specified, the last cne entered 

CLLOAD 

00077 

will be 

in effect. 


CLLOAD 

00079 

CLEAR 

specifies that the load area in storage is to 

be 

CLLOAD 

00080 


cleared to binary zeroes before the cbject files 

ace 

CLLOAD 

00081 


loaded. 


CLLOAD 

00063 

HOCLEAR specifies that the load area is net to be cleared 

CLLOAD 

00084 


before loading. 


CLLOAD 

0 0087 

BESET 

entry 


CLLOAD 

00089 


♦ 


CLLOAD 

00090 


sets the starting location for the programs 

CLLOAD 

00091 


currently loaded. The paraneter 'entry* aust be 

an 

CLLOAD 

00092 


external naae (that is, CSECT, ENTRI, etc.) in 

the 

CLLOAD 

00093 


loaded prograns. If RESET is not specified. 

the 

CLLOAD 

00093 


default entry point is either (1) the entry point 

of 

CLLOAD 

00094 


the first file loaded, (2) the address on an 

END 

CLLOAD 

00095 


card, (3) the location of a nane occurring cn an 

LDT 

CLLOAD 

00096 


card, or (4) the location of the operand on an ENTRY 

CLLOAD 

00097 


card. If * is entered the results are the sane as 

if 

CLLOAD 

00098 


the RESET option vere onitted. 


CLLOAD 

00101 

ORIGIN 

hexloc 


CLLOAD 

00102 


specifies that loading of the prograi is to begin 

at 

CLLOAD 

00103 


hexadeciaal location "hexloc". If TBARS 

is 

CLLOAD 

00104 


specified, the file is loaded into the CBS nucleus 

CLLOAD 

00104 


transient storage locations. If this option is 

not 

CLLOAD 

00105 


specified, loading coaaences at the first available 

CLLOAD 

00106 


user location. 


CLLOAD 

00108 

S4P 

specifies that the file LOAD BAP is to be created 

on 

CLLOAD 

00109 

the prinary disk. 


CLLOAD 

00111 

NONAP 

specifies that the file LOAD BAP is not to 

be 

CLLOAD 

00112 


created. 


CLLOAD 

00115 

TYPE 

types the LOAD BAP at the terninal. This eptien 

is 

CLLOAD 

00116 


valid only if the BAP option is in effect. 


CLLOAD 

00119 

flams 

does not type the LOAD NAP at the terninal. 


CLLOAD 

00121 

Ill 

specifies that invalid card iaages are to 

be 

CLLOAD 

00122 


included in the LOAD BAP file. 


CLLOAD 

00124 

NOIN Y 

specifies that invalid card inages are not to 

be 

CLLOAD 

00125 


included in the LOAD BAP. 


CLLOAD 

00127 

sse 

specifies that Replace card iaages axe to 

be 
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CLLOAD 

CLLOAD 
CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 


included in the LOAD HAP file. 

specifies that Beplace card inages are net to be 
included in the LOAD HAP file. 

specifies that user disks are to be searched for 
TEXT files to resolve undefined references. 

00138 NOAOTO suppresses autonatic searching for TEXT files. 

00140 LIBE specifies that TXTLIB files are to be searched for 

00141 nissing subroutines. If TXTLIB files are to be 

00141 searched, they nust previously have been nade active 

00142 by a GLOBAL connand. 

00144 HOLIBE specifies that TXTLIB files are not to be searched 

00145 for unresolved references. 


00128 


00130 

00131 

MOBEP 

00133 

00135 

M22 


00147 STABT 

00148 

00148 

00149 

00150 

00151 

00151 

00152 

00153 

00154 

00155 

00155 

00156 


specifies that the prograa being leaded is to be 
executed when loading has coapleted. LOAD does not 
normally begin execution of the leaded files. To 
begin execution issediately upon successful 
conpletion of loading, STABT can be specified. LOAD 
then transfers control to an entry point in the 
progran. The default entry point is either the 
address specified in the operand field of the first 
END card containing a non-blank operand field, the 
address of a nane on an LDT card, the beginning of 
the first file loaded if all END cazd isages in the 
TEXT files contain blank operand fields, or the 
BNTBT specified by the user. 
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CLLOAD 

00160 

Besolgti.an of Unresolved -fiefsrences 


CL LOAD 

00167 

i" ■" 1 


—» 

CLLOAD 

00168 

I use standard order of 

i 

CLLOAD 

00169 

I search to locate the TEXT 

i 

CLLOAD 

00170 

| files 

specified by fn ... 

i 

CLLOAD 

00171 

* 


_ j 

CLLOAD 

00172 


I 


CLLOAD 

00173 


1 


CLLOAD 

0017* 

ISIS: 

1 


CLLOAD 

00175 

In final POB r— 

- 1 


CLLOAD 

00176 

this FIG will be | 

unresolved 1 

KG 

CLLOAD 

00177 

redrawn as required j 

references |- 

-search 

CLLOAD 

00178 

1 

7 1 

coaplete 

CLLOAD 

00179 


j 


CLLOAD 

00180 


1 


CLLOAD 

00181 


| IBS 


CLLOAD 

00182 


1 


CLLOAD 

00183 

,— 

i 


CLLOAD 

00184 

1 

NOAUTO | 

TES 

CLLOAD 

00185 

1 

specified |- 

i 

CLLOAD 

00186 

1 

? 1 

1 

CLLOAD 

00187 


- --- i 

1 

CLLOAD 

00188 


1 

1 

CLLOAD 

00189 


| NO 

t 

CLLOAD 

00190 


1 

1 

CLLOAD 

00191 

f - 


■ i I 

CLLOAD 

00192 

| use standard order of 

1 1 

CLLOAD 

00193 

1 search to locate riles 


CLLOAD 

00194 

I with 

a filetype of TEXT 


CLLOAD 

00195 

j and a 

filenane correspon— 


CLLOAD 

00196 

i ding 

to the unresolved 

1 1 

CLLOAD 

00197 

| reference. 


CLLOAD 

00198 



.j 1 

CLLOAD 

00199 


1 

J 

CLLOAD 

00200 


!<- 


CLLOAD 

00201 


1 


CLLOAD 

00202 


r-". . i 


CLLOAD 

00203 


1 I 


CLLOAD 

00204 


1 2.| 


CLLOAD 

00206 


• • 


CLLOAD 

00207 


. • •' 


CLLOAD 

00208 


• # 
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CLLOAD 

00210 

i-» 


CLLOAD 

00211 

II 


CLLOAD 

00212 

1 2 | 


CLLOAD 

00213 

• • 


CLLOAD 

00214 

• • 


CLLOAD 

00215 

* 


CLLOAD 

00216 

1 


CLLOAD 

00217 

1 


CLLOAD 

00218 



CLLOAD 

00219 

| unresolved | NO 


CLLOAD 

00220 

j references j- 

--search 

CLLOAD 

00221 

1 ? 1 

conplete 

CLLOAD 

00222 

1 .. .. a 


CLLOAD 

00223 

g 


CLLOAD 

00224 

| YES 


CLLOAD 

00225 

1 


CLLOAD 

00226 

1 - t 


CLLOAD 

00227 

i NOLIBE | YES 


CLLOAD 

00228 

j specified j-— 

——-search 

CLLOAD 

00229 

1 ? 1 

tereinated 

CLLOAD 

00230 

» . > 


CLLOAD 

00231 

i 


CLLOAD 

00232 

| NO 


CLLOAD 

00233 

1 


CLLOAD 

00234 

r- i 


CLLOAD 

00235 

| search active TXTLIB files (those | 


CLLOAD 

00236 

j which have been previously sped- j 


CLLOAD 

00237 

I fled by a GLOBAL coenand). Files j 


CLLOAD 

00238 

I are searched in the order they | 


CLLOAD 

00239 

j were entered in the connand. 1 


CLLOAD 

00240 

i j 


CLLOAD 

00241 

1 


CLLOAD 

00242 

1 


CLLOAD 

00243 

search tereinated 
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CLLOAD 00248 
CLLOAD 00249 
CLLOAD 00249 
CLLOAD 00250 
CLLOAD 00251 
CLLOAD 00252 
CLLOAD 00252 
CLLOAD 00253 
CLLOAD 00253 
CLLOAD 00254 
CLLOAD 00255 

CLLOAD 00256 
CLLOAD 00257 
CLLOAD 00257 
CLLOAD 00259 

CLLOAD 00260 
CLLOAD 00261 
CLLOAD 00262 

CLLOAD 00264 

CLLOAD 00265 
CLLOAD 00265 
CLLOAD 00267 

CLLOAD 00269 
CLLOAD n 0270 
CLLOAD 00271 
CLLOAD 00272 
CLLOAD 00273 
CLLOAD 00274 
CLLOAD 00274 
CLLOAD 00275 
CLLOAD 00276 
CLLOAD 00277 
CLLOAD 00279 

CLLOAD 00281 

CLLOAD 00282 
CLLOAD 00282 
CLLOAD 00283 
CLLOAD 00284 
CLLOAD 00285 

CLLOAD "0288 
CLLOAD 00290 

CLLOAD 00292 
CLLOAD 00293 
CLLOAD 00294 

CLLOAD 00296 
CLLOAD 00297 


LOAD HAP FIL S: Unless the NONAP option is specified, a load 
■ap ~is created on the primary disk each tiae the LOAD 
coaaand is issued* A load aap is a file that contains the 
location of control sections and entry pcints cf files 
loaded into aain storage. It nay also contain certain 
aessages and card iaages of any invalid cards or replace 
cards that exist in the loaded files. This load aap is 
noraally created as a file with the identifier LOAD HAP. 
Only one such file aay exist on the primary disk. Each tine 
LOAD is issued, a new LOAD NAP replaces any previous LOAD 
HAP file. 

If invalid card iaages exist in the file or files that are 
being loaded, they are listed with the aessage 1KVALID CARD 
in the LOAD NAP.file. To suppress this listing in the load 
aap, the MOINV option aust be specified. 

If Replace (REP) card iaages exist in the file being loaded, 
they are included in LOAD NAP. To suppress this listing of 
REP card iaages, the NOREP option aust be specified. 

DUPL I CATE CSECTS : Duplicate CSECTS (control sections) are 
bypassed by the loader. Only the first CSEC1 encountered is 
physically loaded. The duplicates are not leaded and a 
warning aessage is included in the LOAD HAP. 

LOAD E B CONTROL CARDS : Five types of cards can be added to a 
TEXT file. These are the Set Location Counter (SLC), the 
Include Control Section (ICS), the Replace (REP), the ENTRY, 
and the LIBRARY cards. These are used tc set the aain 
storage location where LOAD begins placing tie file, to aake 
corrections and additions to the relocatable object code in 
aain storage once the file is loaded, tc specify entry 
points, and to specify references that are not to be 
resolved. These cards can be added to the 1EXT tiles which 
have been punched and can then be read back in, or they can 
be added using the EDIT coaaand. 

Set L ocation Counter (SLC) Car d; The SLC card sets the 
location counter used with the loader. The file leaded in 
after the SLC card is placed in aain storage beginning at 
the address set by this SLC card. The SIC card has the 
format shown in Figure 18. It sets the location counter in 
one of three ways: 

1. With the absolute virtual address specified as a 
hexadeciaal nuaber in coluans 7-12. 

2. With the syabolic address already defined as a program 
naae or entry point. This is specified by a syabolic 
naae punched in coluans 17-22. 

3* If both a hexadeciaal address and a syabolic naae are 
specified, the absolute virtual address is ccnverted tc 
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CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 


00298 

00298 

00299 

00300 

00301 

00301 

00302 

00303 

00303 

00304 


binary and added to the address assigned to the 
symbolic naaes the resulting sub is the address to 
which the loader's location counter is set. For 
exaaple, if 0000P8 was specified in coluans 7-12 of the 
SLC card iaage and GAMMA was specified in coluans 
17—21, where GAMMA has an assigned address cf 006100 
(hexadeciaal) „ the absolute address in coluans 7-12 is 
added to the address assigned to GAMMA giving a total 
of 0061F8. Thus, the location counter would be set to 
0061F8. 


00305 

00306 

00307 

00308 

00308 

00309 

00310 

00311 


If there are blanks in both coluans 7-12 and 17-22, or 
the syaboiic naae has not yet been defined, the 
response IMTALID CABD xxx,..xxx is typed or, depending 
on whether the option N01NV or IMV was specified, is 
written in the LOAD HAP file. If only the syaboiic 
address is to be used, coluans 7-12 aust be left blank 
or be all zeros* If only the absolute address is tc be 
used, colnans 17-22 aust be left blank. 
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CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 
CLLOAD 

CLLOAD 


00320 

00321 

00322 

00323 

00324 

00325 

00326 

00327 

00328 

00329 

00330 

00331 

00332 

00333 

00334 

00335 

00336 

00337 

00338 

00339 

00340 

00341 

00342 

00343 

00344 

00345 

00346 

00347 

00348 

00349 


| COLUMN 


1 

CONTENTS j 

| 1 

I 

Load card identification (12-2-9). Identifies this | 
as a card acceptable to the loader. I 

| 2-4 

SLC Identifies 

i 

the type c£ load card | 

| 5-6 

Blank 

i 

i 

| 7-12 

i 

Hexadeciaal address to be added to the value I 
of the syabol, if any, in coluans 17-22. Must j 
be right-justified in these coluans, with unused | 
leading coluans filled in with zeros. I 

| 13-16 

. 

Blank 

i 

i 

| 17-22 

i 

Synbolic naae whose assigned location is used 1 
by the loader. Must be left-justified in these 1 
coluans. If blank, the address in the absolute I 
field is used. j 

1 23 

BLANK 

* 

i 

| 24-72 

Hay be used for 

consents or left blank. 1 

u> 

1 

CD 

O 

Not used by the 
blank or insert 
convenience. 

loader. The user aay leave these | 

progran identificaticn for his own j 

— j 


00352 Figure 18* SLC Card Foraat 
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CLLOAD 00357 
CLLOAD 00358 
CLLOAD 00359 
CLLOAD 00359 
CLLOAD 00361 


Lo gg e r Tera lna tg. ( LQ X). Card: The LDT card is used in a 
TXTLIB as the last record of a aeaber. It iodic ate a to the 
loader that all records for that aeaber have been processed. 
The LDT card aay contain a naae which will be used as the 
entry point for the loaded aeaber. 


CLLOAD 

00368 

CLLOAD 

00369 

CLLOAD 

00370 

CLLOAD 

00371 

CLLOAD 

00372 

CLLOAD 

00373 

CLLOAD 

00374 

CLLOAD 

00375 

CLLOAD 

00376 

CLLOAD 

00377 

CLLOAD 

00378 

CLLOAD 

00379 

CLLOAD 

00380 

CLLOAD 

00381 

CLLOAD 

00383 


»- — 

| COLUMN | 

CONTENTS 


1 

| 1 I 

12-2-9 Punch 


1 2—4 | 

LDT identifies type of card 


| 5-16 | 

Not used. 


1 17-24 | 

1 1 

Blank or entry naae (left justified padded with 
blanks to 8 characters) 


I 25—80 | 

Not used. 


Figure 19. 

LDT Card Foraat 
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CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 


CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 


00388 In cl u de Cont ro l Section <ICS) Card s The ICS card changes 
00389 the length of a specified control section or defines a new 
00390 control section. It should be used only when HEELACE cards 
00391 cause a control section to be increased in length. Ihe 
00392 fornat of an ICS card is shown in Figure 20. An ICS card 
00394 nust be placed at the front of the card deck cr TEXT file. 


00396 
00397 
00398 
00399 
00400 
00401 
00402 
00403 
00404 
00405 
00406 
00407 
00408 
00409 
00410 
00411 
00412 
00413 
00414 
00415 
00416 
00417 
00418 
00419 
00420 
00421 
00422 
00423 
00424 
00425 
00426 
00427 

00429 Figure 20• ICS Card Fornat 


COLOHN 


1 

2-4 

5-16 

17-22 

23 

24 

25-28 


29 

30-72 

73-80 


CONTENTS 


Load card identification (12-2-9). Identifies 
this as a card acceptable to the loader. 

ICS ' Identifies the type of load card. 

Blank 

Control section naae—left-justified in these 
coluans. 

Blank 

, (conaa) 

Hexadeciaal length in bytes of the control 
section. This aust not be less than the actual 
length of the previously specified ccntccl 
section. Hust be right-justifled in these 
coluans with unused leading coluans filled 
with zeros. 

Blank 

Hay be used for consents or left blank. 

Not used by the loader. The user aay leave these 
blank or-insert prograa identificaticn for his 
own convenience. 
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CLLOAD 00434 
CLLOAD 00*35 
CLLOAD 00436 
CLLOAD 00437 
CLLOAD 00438 
CLLOAD 00439 
CLLOAD 00440 
CLLOAD 00441 
CLLOAD 00442 
CLLOAD 00443 
CLLOAD 00444 
CLLOAD 00445 
CLLOAD 00446 
CLLOAD 00447 
CLLOAD 00448 


Beplace (EBP) Card ; A EBP card allows instructions aad 
constasts to be changed and additions sade. The EBP card 
nust be poached in hexadeciaal code. The fcrnat cf a EBP 
card is shown in Figure 21. The data ia colusns 17-70 
(excluding the coaaas) replaces what has already been loaded 
into sain storage, beginning at the address specified is 
colusns 7—12. EBP cards are placed ia the card deck either 
(1) innediately preceding the last card (BID card) If the 
text deck does not contain relocatable data such as address 
constants, or (2) iaaediately preceding the first ELD 
(relocatable dictionary) card if there is zelocatable data 
in the text deck. If additions sade by EBP cards increase 
the length of a control section, an ICS card, which defines 
the total length of the control section, nust be placed at 
the front of the deck. 


CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 


00450 

00451 

00452 

00453 

00454 

00455 

00456 

00457 

00458 


CLLOAD 

00459 

1 


CLLOAD 

00460 

1 

7-12 

CLLOAD 

00461 

1 


CLLOAD 

00462 

1 


CLLOAD 

00463 

1 


CLLOAD 

00464 

\ 


CLLOAD 

00465 

1 

13-14 

CLLOAD 

00466 

1 


CLLOAD 

00467 


15-16 

CLLOAD 

00468 

1 


CLLOAD 

00469 

1 


CLLOAD 

00470 

1 


CLLOAD 

00471 

1 


CLLOAD 

00472 

1 


CLLOAD 

00473 

1 

o 

r» 

1 

r* 

CLLOAD 

00474 

1 


CLLOAD 

00475 

1 


CLLOAD 

00476 

1 


CLLOAD 

00477 

1 


CLLOAD 

00478 

1 

71-72 

CLLOAD 

00479 

1 


CLLOAD 

00480 

1 

73-80 

CLLOAD 

00481 

1 


CLLOAD 

00482 

1 


CLLOAD . 

00483 

«_ 


CLLOAD 

00485 

Figure 


colobi i 


CONTENTS 


2-4 

5-6 


Load card identification (12-2-9). Identifies 
this as a card acceptable to the loader. 

EBP Identifies the type of load card. 

Blank 

Hexadeciaal starting address of the area to be 
replaced as assigned by the assesbler. Host be 
right-justified in these colunns with unused 
leading colnsns filled in with xeros. 

Blank 

BSID —External Synbol Identification-- the 
hexadeciaal nuaber assigned to the cestcol 
section in which replaceaent is to be nade. The 
LISTING file produced by the conpiler indicates 
this aunber. 

A naxiaun of 11 four-digit hexadeciaal fields, 
separated by coaaas, each replacing one previously 
loaded halfword (two bytes). The last field 
east not be followed by a conaa. 

Blank 

Not used by the loader. The nset nay leave these 
blank or insert progran identification for his 
ova convenience. 
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CLLOAD 

00491 

CLLOAD 

00492 

CLLOAD 

00493 

CLLOAD 

00494 

CLLOAD 

00495 

CLLOAD 

00496 

CLLOAD 

00497 

CLLOAD 

00504 

CLLOAD 

00505 

CLLOAD 

00506 

CLLOAD 

00508 


CLLOAD 

00513 

CLLOAD 

00514 

CLLOAD 

00517 

CLLOAD 

00519 

CLLOAD 

00520 

CLLOAD 

00523 

CLLOAD 

00526 

CLLOAD 

00529 

CLLOAD 

00530 

CLLOAD 

00531 

CLLOAD 

n 0 5 3 4 

CLLOAD 

00535 

CLLOAD 

00536 

CLLOAD 

00538 

CLLOAD 

00540 

CLLOAD 

D0542 

CLLOAD 

00543 

CLLOAD 

00543 

CLLOAD 

00544 

CLLOAD 

00546 


CLLOAD 

00550 

CLLOAD 

00551 

CLLOAD 

00552 

CLLOAD 

00553 

CLLOAD 

00554 

CLLOAD 

D0555 

CLLOAD 

00556 

CLLOAD 

00558 

CLLOAD 

00559 


En tr y Card : The ENTRY statement specifies the first 

instruction to be executed. It can be placed before, 
between, or after object modules or ether control 
statements* The format of the ENTRY statement is shown in 
Figure 22. The "external name" is the name of a control 
section or an entry naae in the input deck* It must be the 
name of an instruction, not of data. 

r-1 

I entry ] external name I 

> .. . ..— ------- 

Figure 22. ENTRY Card Format 


The loader selects the entry point for the leaded program in 
the following ways: 

1* From the parameter list on the START command. 

2. From the last RESET parameter in the ICAD cr INCLUDE 
command entered. 

3. From the last ENTRY statement in the input. 

4. From the last LDT card in the input. 

5. From the first assembler- or compiler-produced END 
statement that specifies an entry point if no ENTRY 
statement is in the input. 

6. From the first byte of the first control section of the 
loaded program if no ENTRY statement ard no assembler— 
or compiler-produced END statement specifying an entry 
point. For example: 

ENTRY GO 

Hhere GO is defined as the external naie of the first 
instruction to be executed when the pregram is loaded. 
The address of the instruction, indicated by the 
symbolic name GO, is specified by the loader as the 
starting point of the program when it is executed. 


Library Car d: The LIBRARY statement can be used to specify 
the M never-call w function. The never-call function 
(indicated by an as the first operand) specifies those 
external references that are ££>£ to be resolved by the 
automatic library call during any loader step. it is 
negated when a deck containing the external tame referred to 
is included as part of the input to the loader. The format 
of the LIBRARY card can be seen in Figure 23. The "external 
reference" refers to an external reference that may be 
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CLLOAD 00560 
CLLOAD 00561 
CLLOAD 00562 
CLLOAD 00563 
CLLOAD 00564 


unresolved alter input processing. It is not to te 
resolved. Multiple external references within the 

parentheses Bust be separated by coaaas. The 1IBRAFY 
stateaent can be placed before, between. cr after object 
decks or other control statements. 


CLLOAD 00572 
CLLOAD 00573 
CLLOAD 00574 


f-- 

| LIEBABY | * (external reference) | 

i--—--1 


CLLOAD 00579 Figure 23. LIB BABY Card Format 


CLLOAD 00581 Exaaple 1 


CLLOAD 00585 
CLLOAD 00586 
CLLOAD 00587 


i. . . . 1 ——- 

| LIEBABY | * SINE 

< - -- 


] 


.j 


CLLOAD 00593 
CLLOAD 00594 
CLLOAD 00595 
CLLOAD 00596 


Acti on; * specifies the never-call functicn. SINE is an 
external reference in the output. As a result, if SINE is 
unresolved after input processing, no automatic library call 
is Bade. 


CLLOAD 

00599 

Responses 

CLLOAD 

0 0601 

EXECUTION BEGINS... 

CLLOAD 

CLLOAD 

CLLOAD 

0 0602 
00603 
00604 

START has been specified with LOAD and the leaded program 
has begun execution. Any further responses arc from the 
program. » 

CLLOAD 

00606 

INVALID CARD - XXX...XXX 

CLLOAD 

CLLOAD 

CLLOAD 

CLLOAD 

00607 

00609 

00608 

00610 

INV has been specified with LOAD and an invalid card has 
been found. The message and the contents cf the invalid 
card (xxx...xxx) are listed in the file LOAE KAP. The 
invalid card is ignored and loading continues. 

CLLOAD 

00612 

CONTROL CABD - ... 

CLLOAD 

CLLOAD 

CLLOADN 

D 06 13 
00614 
90001 

A loader or library-search control card has teen encountered 
(that is. ENTRY or LIBBABY). This response is placed in the 
LOAD HAP file. 
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CLLOADM 


CLLOADM 

CLLOADM 

CLLOADM 


CLLOADM 

CLLOADM 

CLLOADM 

CLLOADM 

CLLOADM 

CLLOADM 

CLLOADM 

CLLOADM 

LLOADM 

LLOADM 

LLOADM 

LLOADM 

CLLOADM 


00003 iOAfiflOfi 


00005 The LOADMOD coaaand brings a disk file intc storage. The 
00006 file aust be in absolute core-iaage tern as created Gy the 
00007 GENMOD coanand. 


00017 ,---, 

'"'0018 | LOADMOD | fn [ ft fa] | 

0 0C19 J LOADS | j 

000 20 «-J 


00026 

C 0027 

f n 

is the filenaae of the file tc ce leaded into 
storage. 

00030 

00032 

ft 

is the filetype of the file tc be loaded. ir 
supplied, it aust be MODULE. 

00036 

00037 

0O038 

00038 

00039 

fa 

is the fileaode of the aodule tc be loaded. 

If ft and fa are not supplied, the standard 
order of search is used to locate a file witn 
the specified filenaae and a filetype cf 
MODULE. 
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CLHACLIB 


C LMACLIB 
CLMACLIB 
CLHACLIB 
CLMACLIB 
CLMACLIB 
CLMACL IB 
CLMACLIB 

CLMACLIB 

CLMACLIB 

CLHACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLHACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLHACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLHACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 


00004 MACLI£ 


00007 The MACLIB command is used to create and maintain macro 
00008 libraries. A iacro library consists of macro definitions 
00008 and a dictionary which contains the name of the macro, its 
00009 size, and its location relative to the beginning of the 
00009 library. The MACLIB command does not check the macro 
00010 definitions for errors except for the checking of EACHC and 
00016 MEND statements. 


00022 

r~ 


— 

— ■ . 

-.. — 

-— ———- 

00023 

1 

MACLIB 

1 

1 [GEN} 



00024 

1 

MAC 

1 

((ADD) 

libname fnl ££n2...] 


00025 

1 


1 

( (REP} 

9 


00026 

i 


1 

( DEL 

libname aacname [macname2. 

..macnameN ] 

00027 

1 


1 

C COMP 

libname 


00028 

1 


1 

t 

i— —i 


00029 

1 


1 

( 

1 (TERM) | 


00030 

1 


1 

( MAP 

libname) (DISK) ) 


00031 

1 


i 

l 

) (PRINT) | 


00032 

00033 

1 

i. 


i 

C 

«_ _j 



00041 Fu nctio n 5 gg cfocaed by £he M ACLI B Co mman d 


00043 GEN 

00045 ADD 

00047 REP 

00049 DEL 

00051 COMP 

00053 MAP 

00053 
00 0 54 
00056 


generates a CMS macro library 
adds macros to an existing macro library 
replaces existing macros in a nacre library 
deletes members from a macro library 
compacts a macro library 

lists certain information about the macros in a 
macro library. Available inforsaticc includes 
macro name, size, and location relative to the 
beginning of the library 


00058 libname 

00059 

00059 

00060 


specifies the filename of a mactc library. If 
the file already exists, it must have a filetype 
of MACLIB; if it is being created, it kill have 
a filetype of MACLIB 


00062 fn 

00063 

00064 

00064 

00065 

00*66 


specifies the names of the macrc definition 
files to be used, A macro definiticn tile must 
reside on a CMS disk and its filetype must be 
either MACRO or COPY. Each file may contain one 
or more macros and must contain fixed length, 8C 
character records. 


00067 

0.0068 


In a MACRO file, the MACRO name is taken from a 
prototype card within the macro. 


00069 

*0070 

00071 


If the filetype is COPY and the file contains 
more than one macro, each macro Bust be preceded 
by a control card of the following fcrvat: 
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CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 


CLMACLIB 


CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLMACLIB 

CLNACLIB 

CLMACLI3 


I 


00C78 

00079 

00080 


i-1 

| *COPY aacnaie j 

i.— .i 


00084 
00084 
00085 
C 0085 
00086 
"0086 
00087 
00087 
00088 


The naae on the control card will be the naie cf 
the aacro when it* is placed in the nacre 
library. If there is only one aacro in the COPY 
file and it is not preceded by a CCPY control 
card, its name (in the nacro library) will be 
the same as fn. If there are several nacre 
definitions in a COPY file and the first one is 
not preceded by a COPY control card the entire 
file is treated as one aacro. 


00090 aacnaae 
0 00911 


specifies the naae of a macro which exists in a 
aacro library. 


00095 TERM 

00097 J2X5I 

00100 PRINT 

00101 
00102 
00103 
00104 
00105 
00105 
00106 
00107 
00108 


specifies the device to which the output 
generated by the NAP function is to be written. 
Valid device nanes are DISK (dish file) , PRINT 
(virtual spooled printer) , and TERM (terainal 
typewriter). If no device is specified, DISK is 
assuaed. Since this is the only eptien allowed 
in the MACLIB coaaand, only the first werd after 
the left parenthesis will be eiaained. If the 
DISK option is specified, the infezaation is 
written to a file naaed 'libnaae MAP Al*. If a 
file with that naae previously existed it is 
replaced by the new file. 


00112 2etailed JJesStifiiiSSS °£ ZilH£ti2flS 


00114 GEN Function 

00115 The GEN (generate) function creates a new CMS aacrc library 
00117 with a user-defined filenaae and a filetype of KACIIE. If a 
00117 MACLIB file with the same filenaae already exists, it is 
00118 erased and replaced by the new MACLIB. The new file is 
00119 created froa input files specified by fnl - fnN. Fcr 
00120 exaaple: 
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C LflACLIB 
CLNACLIB 
CLNACLIB 

CLNACLIB 

CLtlACLIB 

CLNACLIB 

CLtlACLIB 

CLNACLIB 

CLNACLIB 

CLNACLIB 

CLNACLIB 

CLNACLIB 

CLNACLIB 

CLNACLIB 

CLNACLIB 

CLNACLIB 

CLNACLIB 

CLNACLIB 


CLNACLIB 

CLNACLIB 

CLNACLIB 

CLNACLIB 

CLNACLIB 

CLNACLIB 

CLNACLIB 

CLNACLIB 


CLNACLIB 

CLNACLIB 

CLNACLIB 

CLNACLIB 

CLNACLI3 

CLNACLIB 


CLNACLIB 

CLNACLIB 

CLNACLIB 

CLNACLIB 

CLNACLIB 

CLHACLI3 

CLNACLIB 


00128 ,---s 

00129 | NACLIB GEN OSBAC ACCESS TINE PUT REGEQU j 

00130 «- 8 

00135 Creates a nev file with the file identifier CSNAC NACLIB 
00137 froa aacros existing in the files with the file identifiers; 

00139 ACCESS (MACRO), TINE (MACHO), PUT (NACBO) and REGEQU (NACBC) 
00140 (COPY }, (COPY }, (COPY ) {COPY } 

00143 If a file naned OSMAC MACLIB existed before issue ct the 
00146 coanand, that file is erased* 

00147 Assuae that the files ACCESS NACBO, TINE CCPY, PUT NACBC, 

00148 and REGEQU COPY exist and contain aacros in the following 

00149 fora. 


00151 

00152 

ACCESS MACRO 

TINE COPY 

PUT MACRO 

GET 

♦COPY TTIHER 

PUT 

00153 

00154 


TTIHER 


00155 

PUT 

♦COPY STIMER 


00156 


STIMER 



REGEC0 COPY 


XREG 

YBEG 


ft 

00159 The resulting file OSMAC NACLIB will contain tte following 
00160 aeabers: 


00163 

00165 

00167 

00169 

00171 

00173 


GET 

PUT 

TTIHER 

STIMER 

PUT 

REGEQU 


00177 Note that the PUT macro, which appears twice in the input to 
00178 the command also appears twice in the output. The NACLIB 
n 0179 command does not Chech for duplicate macro tames. If at a 
00179 later time the user were to request the macrc PUT froa CSNAC 
00180 NACLIB, the first one encountered in the dictionary would be 
00181 used. 


00183 ADD Punction 

00184 The ADD function appends the macro definitions from the 
00185 specified files to an existing macro library with the 

00186 designated filename and a filetype of NACLIB, For example: 

00193 ,-i-8 

00194 | NACLIB ADD OSMAC DCB | 

00195 i- » 
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CLMACLIB 00198 
CLMACLI3 00199 
CLMACLIB 00200 


Assume that OSMAC MACLIB has been created by the example iu 
the explanation of the GEN function above and the file CCB 
COPY exists as follows. 


CLMACLIB 00209 
CLMACLI3 00205 
CLMACLIB 00206 
CLMACLIB 00207 


♦COPY DCB 

DCB macro definition 
♦COPY DCBD 

DCBD aacro definition 


CLMACLIB 00211 
CLMACLIB 00212 


The resulting 
aeabers: 


OSMAC 


MACLIB will contain the 


follcwicg 


CLMACLIB 0^215 
CLMACLIB 0 0216 
CLMACLIB 0 0 217 
CLMACLIB 00218 
CLMACLI3 00219 
CLMACLIB 00220 
CLMACLIB 0 *221 
CLMACLIB 00222 


GET 

PUT 

TTIMER 

STIME8 

PUT 

HEGEQ0 

DCB 

DCBD 


CLMACLIB 00228 


DEL Function 


CLMACLIB **229 
CLMACLI3 00230 
CLMACLIB *0230 
CLMACLIB 00231 
CLMACLIB 00231 
CLMACLIB 00232 
CLMACLIB *0232 
CLMACLIB 00235 


The DEL (delete) 
froa the aacro 
dictionary so there 
definition still exists 


function reaoves the specified nacre naae 
library dictionary and coapresses the 
are no unused entries. The macro 
in the library, but since no 
dictionary entry exists it cannot be accessed or retrieved. 
If the user atteapts to delete a aacro for which twe aacrc 
definitions exist in the aacro library, only the first one 
encountered is deleted. For exaaple: 


CLMACLIB 00237 
CLMACLIB 00238 
CLMACLIB 00239 


I --- 1 

| MACLIB DEL OSMAC GET POT TTIMER DCB J 


L 


J 


CLMACLIB "0242 
CLMACLIB 00243 
CLMACLIB 00244 
CLMACLIB *0246 


Deletes aacro nanes GET. OPEN. TIME, and CCB from the 
dictionary of the aacro library named OSMAC RACL1E. assuaing 
that OSMAC exists as in the ADD function exaaple. After the 
above coaaand. it will contain the following aeabers: 


CLMACLIB *0249 SIIMER 

CLMACLIB 00251 PUT 

CLMACLIB *0253 R3GEQU 

CLMACLIB * 0255 DCBD 


CLMACLIB *0258 REP Function 


CLMACLIB 00259 
CLMACLIB *0260 
CLMACLIB 00263 


REP (replace) is effectively a del 
an ADD function. REP will delete 
the aacro definition in the files 


ete function followed 
the dictionary entry 
specified by frl-fnN. 


by 
i cr 
It 
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CLMACLIB 00261 
CLMACLIB 00263 
CLMACLIB 00264 
CLMACLIB 00266 


then appends the new aacro definitions to tie macro library 
and creates new dictionary entries. For example, assuae that 
a aacro library MYMAC MACLIB contains the following aeabers 
A, B, and C, and that the following coaaand is entered: 


CLMACLIB 00268 
CLMACLIB 00269 
CLMACLIB 00270 


i--— .....> 

| MACLIB REP HYHAC A Cj 


L. 


J 


CLMACLIB 00273 
CLMACLIB 00274 
CLMACLIB 00275 
CLMACLIB 00275 
CLMACLIB 00276 


The files represented by file identifiers A KACFO and C 
MACRO each have one aacro definition. After execution cf 
the coaaand, MYHAC MACLIB will contain meabers with the sane 
naaes as before, bat the contents of A and C will be 
different. 


CLMACLIB 00279 


COMP Function 


CLMACLIB 00281 
CLMACLIB 00281 
CLMACLIB "0282 
CLMACLIB 00282 
CLMACLIB 00283 
CLMACLIB 00285 


Execution of a MACLIB coaaand with the DEL cr REP functions 
can result in unused space within a aacro lilrary. The CCMP 
(coapress) function is used to coapress a aacro library 
(that is, reaove any aacros for which there is nc dicticnacy 
entry). This function uses a teaporary data set naaed 
MACLIB CMSUT1. For exaaple, the coaaand: 


CLMACLIB 00287 
CLMACLIB 00288 
CLMACLIB 00289 


i—- - 1 - 

| MACLIB COMP MY MAC 

i__ 



CLMACLIB 00293 


Coapresses the library MYMAC MACLIB. 


CLMACLIB 00295 


MAP Function 


CLMACLIB 00296 
CLMACLIB 00297 
CLMACLIB 00297 
CLMACLIB 00298 
CLMACLIB 00299 


The HAP function creates a list containing the name of each 
aacro in the dictionary, the size of the xacrc and its 
position within the aacro library. The user may specify the 
device to which the list is to be written. Acceptable 
devices are: 


CLMACLIB 00302 DISK 
CLMACLIB 00303 


the list is placed in a file with the file 
identifier *libnaae MAP Al*. 


CLMACLIB 00306 EBIfil 


the list is spooled to the printer. 


CLMACLIB 00309 TERM 


the list is typed at the terminal. 
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CLNODNAP 


CLMODMAP 

CLMODMAP 

:lmodmap 

CLMODMAP 

CLMODMAP 

CLMODMAP 

CLMODMAP 

CLMODMAP 

CLMODMAP 

CLMODMAP 

CLMODMAP 

CLMODMAP 

CLMODMAP 


CLMODMAP 


CLMODMAP 

CLMOVEFI 


00003 MODHA P 


00007 The MODMAP connand types the load nap associated with the 
00008 specified MODULE file. Two types of nodules contain no lead 
00009 nap and therefore produce an error nessage when they are 
00009 specified in a MODMAP connand. They are (1) CMS transient 
00011 area nodules and (2) MODULE files created »ith the GENNCC 
00012 connand using the NOHAP option. 


00"19 

00020 

00021 

00022 


r 


| MODMAP | 
| HOD | 


fn | 

I 


00028 fn 

00029 

00030 


is the filenane of the MODULE file whose lead 
nap is to be typed. The filetype cf the file 
nust be MODULE. 


00033 Be sponses 

00034 The LOAD MAP associated with the file will be typed at the 
00001 terainal. 
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CLMOVEFI 

CLMOVEFI 

CLMOVEFI 

CLMOVEFI 

CLMOVEFI 

CLMOVEFI 

CLMOVEPI 


CLMOVEFI 

CLMOVEFI 

CLMOVEFI 

CLMOVEFI 

CLMOVEFI 

CLMOVEFI 

CLMOVEFI 

CLMOVEFI 

CLMOVEPI 

CLMOVEFI 

CLMOVEFI 

CLMOVEFI 

CLMOVEFI 

CLMOVEFI 

CLMOVEFI 

CLMOVEFI 

CLMOVEFI 

CLMOVEFI 

CLMOVEFI 

CLMOVEFI 

CLMOVEFI 

CLMOVEPI 


CLMOVEFI 

CLMOVEFI 

CLMOVEFI 

CLMOVEFI 


IBM CONFIDENTIAL 


00003 MO VEFILE 


00006 

00006 

00007 

00008 

00009 

00010 

00011 


The MOVEFILE coaaand allows the user to move data from any 
device supported by VM/370 to any other device supported ty 
VM/370. The coaaand accepts two ddnames as argunents. The 
FILEDEP coaaand aust have been used to specify devices or 
disk files which these ddnaaes represent. The command moves 
data records froa the device or file specified by the first 
ddnaae to the device or file specified by the seccnd ddname. 


00022 

00023 

00024 

00025 

00026 

O0027 


r 


1 


J Hr r i t J 

S MOVEFILE | |input—ddnaae | out put-ddname| j j 
I MOVE | J INMOVE j OUTMO VE | | | 

I_ I *■ L J J I 


00032 

00033 

00033 

00034 

00035 


input-ddnaae specifies the ddnaae representing a file 
definition which describes the device cr disk 
file on which the data to be moved currently 
resides. If ddname is not specified, the 
default name INMOVE is used. 


00038 
00039 
00039 
0004 0 
00041 


output—ddnaae specifies the ddnaae representing a file 
definition which describes the device or disx 
file to which the data is to be written. If 
ddnaae is not specified., the default name 
ODTMOVB is used. 


00043 

00044 

00045 

00046 

00047 

00048 


Note : Noraally the user should have used the FIIEDEF coaaand 
to establish device characteristics for the ddnaae specified 
with the coaaand. If the user does not do this, the OS Kacrc 
Simulation routines will supply default characteristics. 
For example, if the ddnaae is X a default FILEDEI X DISK 
FILE X A1 coaaand will be perforaed. 


00051 Default Dev j.ce Attributes : If the user has not specified 
00051 certain file attributes in his file definition (such as 
00052 record foraat and blocksize), the MOVEFILE ccaaand assumes 
^0053 the values shown in Figure 24. 
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C L MOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEPI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 
CLMOVEFI 

CLMOVEFI 


CLMOVEFI 

CLMOVEFI 

CLMOVEFI 

CLMOVEFI 

CLMOVEFI 
CL MOV EFI 
CLMOVEFI 


CLMOVEFI 


CLMOVEFI 

CLMOVEFI 


00061 

00062 

00063 

9006U 

9 0°65 

i— 

| Device 


INPUT DDNAME 


| OUTPUT CINABE 

RECFM | 

BLOCKSIZE 

| RECFM 

| cLCCKSlZE 

n 0°66 

1 






00967 

| Card Reader 


F | 

BC 

1 n/a 

1 N/A 

00068 







00069 

| Card Punch 


N/A | 

N/A 

1 F 

1 o C. 

00070 

1 


1 


1 


00071 

| Printer 


M/A 1 

N/A 

t U 

i 133 

00072 

1 


1 


1 


0 0073 

] Terminal 


U j 

130 

1 u 

i 130 

00074 

1 


s 


i 


00075 

| Tape * 


a l 

3600 

i RECFM Cl 

|BLOCK cf In 

00076 

1 


1 


| Input ddname 

I ddname 

00077 

1 

! 

i 


1 


00078 

| Existing Disk 


RECFM Of 1 BLOCK of 

j RECFM Ct 

IBICcK of 

r^n7q 

1 f ile 


file j 

file 

| file 

I file 

""080 



5 


1 


"0081 

I New Disk file 


N/A | 

N/A 

| RECFM ct 

I BLOCK of xn 

00"82 

1 




| Input danaoe 

| ddname 

O0083 

1 


1 




0 0084 

| Dummy 


N/A | 

N/A 

j RECFM or 

|bICCK or In 

00085 



1 


(Input ddname 

I ddname 

" or 







00087 







O0083 

j * If the default 

record format and 

blocKsi 2 e are used in a tape 

-tc-tape aove 

0 0089 

| operation and 

an 

input record is 

greater than 360C tytes, it 

will be 

00090 
o 0"91 

| truncated to 3600 

E_— 

bytes on the output tape. 



00093 

Figure 24. Default 

Device Attributes 

fcr MOV IFILI 

command 



00098 


Example 


on loo 
00101 
n 0102 


| MOVEFILE | NEWMAST 

i_ 


OLDNAST 


00107 Acti on: The existing file referred to by the FIIEDIF daname 
n 0108 NEWMAST is moved to the file whose defiuitior is referred to 
00109 by a FILEDEF ddname of OLDMAST. 


00111 

Be§£2fises 


""114 

DMSMVE706I CONSOLE 

INPUT — TYPE 

00113 

The input-ddnaae in 

the MOVEPILE 


NOLL LINE FCR END OF DAI A 
command refers to a device 
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CLMOYEFI 00118 
CLMOVBFI 00119 
CLPRINT 00001 


type of TEHHINAL. This nessage proipts the user to begin 
entering the input data and instructs his to enter a null 
line to tersinate input. 
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CLPRINT 


3LPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

:lprint 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 


CLPRINT 


CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 

CLPRINT 


00012 


Elliil 


00*14 The PBINT coaaand prints the specified file cn the spooled 
00017 virtual printer. The file aay contain carriage control 
00017 characters and Bay have either fixed or variable length 
00018 records. 


00020 


00048 

00048 

*0049 


00021 

1 

PRINT 

1 

fn ft [fa] 

[ (options.. .) 1 

1 


00022 

1 

PR 

1 




1 


00023 

1 


1 

afilians: 

fCCINOCC 1 

1 


00024 

1 


1 



[UPCAS E J 

1 


00025 

1 


I 



r 

i 1 


r '0O26 

1 


1 



| MEHBEH (* 

} 1 1 


00027 

1 


i 



| Inane 

)l 1 


0 0028 

1 


1 


0 

L 

j | 


00029 

1 


s 



[HEX ] 



00030 

i_ 






n | 


00035 

fn 



specifies 

the 

filenaae of 

• the file to 

be 

00037 




printed. 

This 

field aust be 

specified. 


00040 

ft 



specifies 

the 

filetype of 

the file tc 

be 

00042 




printed. 

This 

field aust be 

specified. 


00045 

fa 



specifies 

the 

fileaode of 

the file to 

re 

00046 




printed. 

If this field is 

specified as 

an 

00046 




aster isk ( 

*), the standard order of search 

is 

00047 




followed 

and the first file 

encountered wi 

th 


the given filenaae and filetype is printed. 
If fa is not specified, the priaary disk and 
its extensions are searched. 


00052 Options 


000 54 
90055 
00956 
00057 

cc 


specifies that the first character of each 
record is to be interpreted as a carriage 
control character. If the filetype is 
LISTING, this is the default. 

00060 

00061 

9 09^2 

NOCC 


specifies that the first character of eacn 
record is not to be interpreted as a carriage 
control character. 

90067 

9*069 

99*72 

UPCASE 

none 

UP 


specifies that lowercase characters in the 
file are to be translated to uppercase in the 
printout. 

00077 

00079 

HEMBERp 

none 

J 

if ft is HACLIB, this option aay be specified 
If * is entered, all individual aeabers cf 


181 





IBM CONFIDENTIAL 


CLPRINT 

CLPRINT 

00084 

00085 

MEN (naae) that HACLIB ace printed. 12 a naae ia 

specified, only the naaed aeaier is printed. 

CLPRINT 

CLPRINT 

00088 

00089 

HEX specifies that the file is tc be printed in 

hexadeciaal foraat. 

CLPRINT 

00095 

Exaaple 1 

CLPRINT 

CLPRINT 

CLPRINT 

00097 

00098 

00099 

■-- — i 

| PRINT | ACCESS HACLIB (HENBER GET) | 
i--- j 

CLPRINT 

CLPRINT 

CLPRINT 

00103 

00104 

"0105 

Action: The contents of nenber GET in file ACCESS HACLIB is 
spooled to the printer. The first charactei of each record 
in the file is not treated as carriage contrcl. 

CLPRINT 

00107 

Exaaple 2 

CLPRINT 

CLPRINT 

CLPRINT 

00109 

00110 

00111 

i - - i 

| PRINT | OLDHAST NAHE (CC) j 

•_' j 

CLPRINT 

CLPRINT 

CLPRINT 

oom 

00115 

00118 

Action: The contents of the file OLDHAST NAHI are spooled to 
the printer and the first character of each record in the 
file is used for carriage control. 

CLPRINT 

00120 

Responses 

CLPRINT 

CLPRINT 

CLPRINT 

CLPUNCH 

00121 

00122 

00123 

"0001 

The READ! aessage indicates the ccaaand has completed 
without error, (that is, that the file has been written to 
the spooled printer). The file is now under the control cf 
CP*8 spooling functions. 
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CLPONCH 


CL PUNCH 
CLPUNCH 
CLPUNCH 
CLPONCH 
CLPUNCH 

olpunch 

CLPUNCH 

CLPONCH 

CLPONCH 

CLPUNCH 

CLPUNCH 

CLPUNCH 

CLPUNCH 

CLPUNCH 

CLPUNCH 

CLPUNCH 

CLPUNCH 

CLPUNCH 

CLPUNCH 

CLPUNCH 

CLPUNCH 

CLPUNCH 

CLPONCH 

CLPONCH 

CLPUNCH 

CLPONCH 

CLPONCH 

CLPONCH 

CLPONCH 


00011 £UN£H 


0^014 The PUNCH coaaand causes a specified disk file tc he spooled 
00015 to the punch, PUNCH accepts fixed or variable length records 
00U16 so long as no record exceeds B0 characters. Records with 
00017 less than 80 characters are right padded with flacks to 80 
00019 characters. Records larger than 80 characters are rejected. 


00021 

00^22 

00023 

00024 

00025 

00026 


I I r i 

| PUNCH | fn ft ££«] | (HEADER) | 

| PO |(NOHEADER) | 

| | c J 


I 

I 

I 

I 


00031 

f n 

specifies the 

filename 

cf 

tie file 

tc fce 

00033 


punched. This 

field aust be specified. 


00035 

ft 

specifies the 

fiietype 

of 

the file 

to be 

00037 


punched. This 

file aust be 

speci lied, 


00039 

fa 

specifies the 

filemode 

of 

the file 

tc be 

00040 


punched. If 

this field 

is 

sped fied 

as an 

00041 


asterisk (*), 

the standard 

order cf search is 

00041 


followed and 

the first 

acceptatla 

file 

00043 


encountered is 

punched. If 

fa 

is net speciried. 

0^043 


the priaary 

disk and 

i t s 

extensions 

are 

00044 


searched. 






00047 


00049 HEAD ER 

00051 none 

00053 fi 

00054 

00054 

00056 


indicates that a control card is tc fe inserted 
in the punched output preceding the specified 
file. This control card is intended for use in 
identifying the file for a subsequent REAECARE 
coaaand .to restore the file tc a disk. Ihe 
control card foraat is shown in Figure 25. 


1c3 


IBM CONFIDENTIAL 


CLPUNCH 00062 
CLPUNCH 00063 
CLPUNCH 00064 
CLPUNCH 00065 
CLPUNCH 00066 
CLPONCH 00067 
CLPONCH 00068 
CLPONCH 00069 
CLPONCH 00070 
CLPONCH 00071 
CLPONCH 00072 
CLPONCH 00073 
CLPONCH 00074 
CLPONCH 00075 
CLPONCH 00076 
CLPONCH 00077 
CLPONCH 0O078 
CLPONCH 00079 
CLPONCH 00080 
CLPONCH OOO01 
CLPONCH 00082 
CLPONCH 0 0083 
CLPONCH C0084 
CLPONCH 00085 
CLPONCH 00086 
CLPONCH 00087 
CLPONCH 00088 
CLPONCH "0089 
CLPONCH 00090 
CLPONCH 00091 
CLPONCH 00092 
CLPONCH 00093 
CLPONCH 00094 
CLPONCH 00095 
CLPONCH 00096 
CLPONCH 00097 

CLPONCH ""102 Figure 25. Header Card Fornat 


CLPONCH 00106 NOHEADER no header control card is to be inserted in the 
CLPONCH 00107 none punched deck. 

CLPONCH 00109 NOH 


CLPONCH 00111 Exaaple 

CLPONCH "0113 ,-—-1 

CLPONCH. 00114 | PUNCH | NEWMAST TRANS (NOH) | 

CLPONCH 00115 »•-- 

CLPUNCH 00120 Actio n; The file NEVNAST TRANS is spocled tc the punch. No 

CLPUNCH 00121 header card is punched preceding the output deck. 


1— 

Coluonj 

Nuiber of 
Characters 

1 1 

|Contents| Meaning 

—i 

1 1 

1 

1: 

I 

(identifies card 
|as a control card 


2-5 | 

4 

i 

i READ 

1 

(identifies card as 




1 

|a READ control card 


6-7 | 

2 

9 

|blank 

1 

I 


8-15 J 

8 

)fnaae 

(filename of the 

1 



1 

(file punched 


16 | 

1 

1 

|blank 

1 

1 


17-24 | 

8 

1ftype 

1 

(filetype of the 
(file punched 


25 | 

1 

1 

| bl an k 

1 

1 


26-27 | 

2 

j fnode 

1 

(filenode of the 
(file punched 


28 | 

1 

1 

|blank 

I 

1 


29-34 | 

6 

j volid 

1 

(label of the disk fic» 

|which the file kas read 


35 j 

1 

jblank 

1 

1 


36-4 3 1 

8 

|nn.dd. 

yyjthe date that the file was 




1 

(last written 


44 | 

1 

i 

|blank 

1 

1 


45-52 | 

8 

j hh.an. 

1 

ss|the tine cf day that the 
(file was writter to disic 


153-80 J 

i_ 

28 

1 

| blank 

1 

1 
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CLPUNCH 

00124 

CLPONCH 

00127 

CLPONCH 

00129 

CLQOERI 

00001 


Resp o nses 

If the coaeand has coapleted without error (tie file nas 
been successfully spooled), the READY aessace appears. The 
file is now under control of CP spooling functions. 
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CLQUERY 

00005 






CLQOERY 

00008 

The QOERY 

coaaand 

provides 

the user with certain information 

CLQOERY 

00009 

about his 

virtual 

■achine 

environment. Information which 

CLQOERY 

00010 

■ay be obtained 

includes: 


CLQOERY 

00013 

1. the 

state 

of 

any of the virtual machine characteristics 

CLQOERY 

00015 

which are 

■ ai ntained 

by the CMS SET ccmiand. 

CLQOERY 

0 00 18 

2. file 

definitions (FILEDEFs) which are in effect. 

CLQOERY 

00021 

3* the 

status 

of 

the disks attached to the user's virtual 

CLQOERY 

00022 

■achine. 




n t Aiipp v 

00032 






u Ly ud nx 







CLQOERY 

00033 

i QOERY 


{ 

BLIP 

} 1 

CLQOERY 

00034 

1 Q 

1 

( 

RDYMSG 

} i 

CLQOERY 

00035 


1 

C 

LDRTBLS 

} 1 

CLQOERY 

00036 

1 

1 

{ 

RELPAGE 

} 1 

CLQOERY 

00037 

1 

1 

C 

IMPCP 

} 1 

CLQOERY 

00038 

1 

1 

t 

IMPEX 

} I 

CLQOERY 

00039 

1 

i 

( 

ABBREV 

} i 

CLQOERY 

00040 


1 

{ 

REDTYPE 

i 1 

CLQOERY 

00041 


1 

c 

PROTECT 

) 1 

CLQOERY 

00042 

1 

1 

c 

SEARCH 

} 1 

CLQOERY 

00043 


1 

{ 


r i ) 1 

CLQOERY 

00044 


1 

c 


|Bode| } j 

CLQOERY 

00045 


i 

c 

DISK 

1 * 1 > 1 

CLQOERY 

00046 

1 

1 

c 


«• ■» } 1 

CLQOERY 

00047 


1 

c 


{SYSTEM} } } 

CLQOERY 

00048 

1 

1 

{ 

SYNONYM 

(USER } } 1 

CLQOERY 

00049 

1 

1 

{ 


{ALL } } | 

CLQOERY 

0 0050 

1 

1 

c 


} 1 

CLQOERY 

00051 


1 

( 

FILEDEF 

} 1 

CLQOERY 

00052 

1 

1 

c 

NACLIB 

} I 

CLQOERY 

00053 

1 

1 

c 

TXTLIB 

} 1 

CLQOERY 

00054 

1 

1 

t 

LIBRARY 

} 1 

CLQOERY 

00055 


1 

c 

INPUT 

} 1 

CLQOERY 

00056 

I 

1 

c 

OUTPUT 

} 1 

"• t n n w n Y 

o 0057 

a_ 




- -----.- a 

v« L«Vc u JL\ I 

CLQOERY 

00062 

Sjgl Ccgaapd £u£c&ons; The 

SET Command description presents 

CLQOERY 

00069 

detailed 

descriptions of the following functions: 

CLQOERY 

00076 

BLIP 

displays 

the BLIP character(s) . 

CLQOERY 

0C078 


response 

: BLIP 

* (XXXXXXXX) 

CLQOERY 

00080 





(NONE j 
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CLQUERY 

^0084 

BDYMSG 

displays the RDYMSG format. 

CLQUERY 

00088 


r i 

CLQUERY 

00090 


response: RDYMSG = |LMSGf 

CLQUERY 

00091 


ISMSGJ 

CLQUERY 

00092 


L i 

CLQUERY 

00093 


LMSG—standard CMS READY message 

CLQUERY 

00095 


provided. For example: 

CLQUERY 

00097 


R; T = 0. 12/0.33 17:C€:2C 

CLQUERY 

00099 


SMSG—shortened CMS READY message 

CLQUERY 

00099 


excluding date and time is 

CLQUERY 

0 0100 


provided. Por example: 

CLQUERY 

00102 


«; 

CLQUERY 

00107 

LDRTBLS 

displays the number of loader tables the user has. 

CLQUERY 

00109 


response: LDRTBLS = nn 

CLQUERY 

00111 

BELPAGE 

indicates whether pages of stcrage in which 

CLQUERY 

00112 


certain commands have completed eiecuticr are to 

CLQUERY 

00113 


be released or retained. 

CLQUERY 

00115 


r t 

CLQUERY 

00117 


response: BELPAGE = |ON j 

CLQUERY 

00118 


|OFP | 

CLQUERY 

00119 


L J 

CLQUERY 

00120 


ON - pages will be released. 

CLQUERY 

0^122 


OFF—pages will be retained. 

CLQUERY 

00126 

III POP 

displays status of implied CP command indicate!. 

CLQUERY 

00128 


r i 

CLQUERY 

00130 


response: INPCP = |ON | 

CLQUERY 

00131 


| OFF | 

CLQUERY 

"0132 


L J 

CLQUERY 

00136 


ON—--commands not recognized by CMS will 

CLQUERY 

00137 


be passed to CP. 

CLQUERY 

00138 


OFF—commands not recognized by CMS will 

CLQUERY 

00140 


be flagged as ununcfcn tc CtS. 

CLQUERY 

00146 

IHPEX 

displays status of implied EXEC incicatcr. 

CLQUERY 

00148 


r t 

CLQUERY 

00150 


response: IHPEX = |ON ( 

CLQUERY 

00151 


(OFF | 

CLQUERY 

00152 


L J 

CLQUERY 

00155 


ON---EXEC files may be executed fay 

CLQUERY 

00156 


entering filename of file. 

CLQUERY 

00157 


OFF—the EXEC command must be explicitly 

CLQUERY 

00158 


entered to execute EXEC files. 

CLQUERY 

00161 

ABBREV 

displays the status of the minimum abbreviation 

CLQUERY 

00162 


indicator. 



IBM CONFIDENTIAL 


CLQUERY 

00165 




r ■» 


CLQUERY 

00167 


response: 

ABBBEV » 

|ON | 


CLQUERY 

00168 




|QFF| 


CLQUERY 

00169 




L J 


CLQUEHT 

00170 



ON-minima CMS coamano atttc viaticus 

CLQOERY 

00171 



(truncations) will be accepted. 


CLQUERY 

00172 



OFP—ainiaua coaaand abbreviations 

CLQUERY 

00173 



(truncations) will not be accepted. 

CLQUERY 

00177 

REDTYPE 

displays 

the status 

of the REDTYPE indicator. 


CLQUERY 

00180 




r i 


CLQUERY 

00182 


response: 

REDTYPE = 

ION | 


CLQUERY 

00183 




| OFF | 


CLQUERY 

00184 




L J 


CLQUERY 

00187 



ON— cas 

error messages bill be typed 

in 

CLQUERY 

00188 



red. 

providing the tervinal 

is 

CLQUERY 

00188 



equipped with the two-color ribbon 

CLQUERY 

00189 



feature. 


CLQUERY 

00190 



OFF—CHS 

error messages will not 

be 

CLQUERY 

00191 



typed in red. 


CLQUERY 

00197 

PROTECT 

displays 

the status 

of CHS nucleus protection. 


CLQUERY 

00199 




r i 


CLQUERY 

00201 


response: 

PROTECT ■ 

ION | 


CLQUERY 

00202 




|OFF| 


CLQUERY 

00203 




3 J 


CLQUERY 

00205 



ON-CHS 

nucleus protection is 

in 

CLQUERY 

00206 


effect. 




CLQUERY 

00207 



OFF—CHS 

nucleus protection is not 

in 

CLQUERY 

00208 


effect. 





CLQUERY 

00212 

cas fiis& status functions 



CLQUERY 

09214 

SEARCH displays 

the search 

order 

of all CHS disks 

CLQUERY 

09215 

currently 

accessible. 



CLQUERY 

09219 



r 

i 

CLQUERY 

00221 

response: 

volid vaddr 

node |B/0| 

CLQUERY 

00222 


• 

IR/WI 

CLQUERY 

00223 


e 

i 

J 

CLQUERY 

00224 


6 


e 
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CLQUERY 

CLQUERY 

CLQOERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 


CLQUERY 


CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 

CLQUERY 


00230 

00231 

DISK 

■ode displays the status of the single disic 
represented by •■ode'. 

0 0236 
00237 
00238 
00239 
00240 


response: node (vaddr): nn PILES, nnnn 8EC IN USE, nunc 

r t 

nnX FULL (n CYL), type|E/O| 

|R/li| 
i j 

00243 

00244 


If the disk with the specified acoe has net been 
accessed, the response is 

"0246 


DISK *sodQ* NOT ACCESSED 

00250 

DISK 

* displays the status of all CKS disks. 

00255 

00257 


response: saie as for QUERY DISK oede; cnc line is 
typed for each accessible disk. 

00262 

ZMSlions 

00265 

00265 

"0266 

SYNONYM 

SYSTEM displays CHS system synoryas in effect. 
"Appendix H: Hiniana Truncations fer CMS Coasand 
Maaes” presents a suaaary of systea synenyas. 

00270 

00271 

00272 

00273 

00274 

00275 


SYSTEM SHORTEST 

response: £213412 _£211 

coaaand ainiaua truncaticn 

» • 

• « 

C» • 

00278 

"0280 


If no systea synonyms are in effect, the following 
aessage is typed out: 

00282 


NO SYSTEM synonyms in effect 

00285 

SYNONYM 

USER displays user synonyans in effect. 

"0288 

00289 

"0290 

00291 

00292 

00293 


response: SYSTEM USER SHORTEST 

£211412 sjf no NXH I221_ill_ill) 
coaaand synonya otiniaun truncation 

• • • 

• • « 

Q O 0 

C 0296 
"0297 


If no U3er synonyas are in effect, tte following 
message is typed out: 

" "299 


NO USER SYNONYMS IN EFFECT 


1fc9 


IBM CONFIDENTIAL 


CLQOERY 

00302 

SYNONYM 

ALL displays all synonyms in effect. 

CLQUERY 

0 0306 


response: Sane as SYNONYM SYSTEM and SYNONYM USER. 

CLQOERY 

00313 

FILEDEF 

displays all file definitions in effect. 

CLQOERY 

00315 


response: ddnaae device [fn [ftj] 

CLQOERY 

0 0 316 


If there are no user file definitions in effect. 

CLQOERY 

00318 


the following message is typed out: 

CLQOERY 

00320 


NO USER DEFINED FILEDEF'S IN EFFECY 

CLQOERY 

00323 

MACLIB 

displays the names of all files with a filetype cf 

CLQOERY 

00323 


MACLIB (libraries to be searched for macro 

CLQOERY 

00324 


definitions) . 

CLQOERY 

00326 


response: MACLIB * libname... 

CLQOERY 

00327 


If no MACLIBS are searched for macro definitions. 

CLQOERY 

00328 


the response is 

CLQOERY 

00330 


MACLIB = NONE 

CLQUERY 

00333 

TXTLIB 

, displays the names of all files with a filety^e ot 

CLQOERY 

00333 


TXTLIB (libraries to be searched fee -unresolved 

CLQOERY 

■'0334 


references)» 

CLQOERY 

00336 


response: TXTLIB = libname... 

CLQOERY 

0 0337 


If no TXTLIBs are searched fee unresolved 

CLQOERY 

00339 


references, the following message is typed cut: 

CLQOERY 

00341 


TXTLIB = NONE 

CLQOERY 

00343 

LIBRARY 

displays the names of all MACLIB and TXTLIB files 

CLQOERY 

0 0345 


which are to be searched. 

CLQOERY 

**347 


response: MACLIB = libname...JNONE 

CLQOERY 

C 0349 


TXTLIB * libname...|NONE 

CLQOERY 

00351 

INPOT 

displays the contents of the user input translate 

CLQOERY 

00353 


table if he has specified one. 

CLQOERY. 

*0 357 


response: INPUT al xxl 

CLQOERY 

* 0358 


« • 

CLQOERY 

**359 


0 0 

CLQOERY 

00360 


• . • 

CLQOERY 

00361 


an xxa 
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CLQOERY 

CLQOEBY 

CLQOERY 


CLQOERY 

CLQOERY 

CLQOERY 

CLQOERY 

CLQOERY 

CLQOERY 

CLQOERY 

CLQOERY 

CLQOERY 

CLQOERY 


CLQOERY 


CLQOERY 

CLREADCD 


00362 If no user translate table is in effect, the 

00363 response is 

00365 NO OSER DEFINED INPUT TRANSLATE TAELE IN EFFECT 


00367 OOTPOT displays the contents of the user cutpot translate 
00369 table if he has specified one. 

00371 
00372 
00373 
00374 
00375 


response: OUTPUT xxl al 


xxn an 


00376 

00377 


If no user output translate table has been 
defined, the response is 


00379 


NO USER DEFINBD OUTPUT TRANSLATE TABLE IK EFFECT 


00383 SesP9q?9g 

00384 The status of the specified function is typed cn the 

00001 terninal in the foreat shown following the ccnnand. 
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CLBKADCD 00003 BEADC AHD 


CLREADCD 00006 
CLREADCD 00007 
CLREADCD 00008 
CLREADCD 00008 
CLREADCD 00009 
CLREADCD 00010 
CLREADCD 00012 


The READCARD coaaand reads data records froa the spooled 
card unit input device and creates files on disk ccntaining 
the data records. The data records aust be fixed length and 
are noraally 80 characters although they aay ccnsist of up 
to 132 characters. Records of less than 80 characters cannot 
be read. If a file exists with the saae identifiers as the 
one to be created it is erased. 


CLREADCD 00013 
CLREADCD 00014 
CLREADCD 00015 
CLREADCD 00016 
CLREADCD 00017 
CLREADCD 00018 
CLREADCD 00018 
CLREADCD 00019 
CLREADCD 00020 
CLREADCD 00021 


The deck entered through the card reader way contain any 
nuaber of files# each iaaediately preceded by a BEAC control 
card specifying the filenaae# filetype# and optionally# 
fileaode. These control cards are typed at the terainal as 
they are encountered# and are interpreted by the systea just 
as if fn ft fa had been entered froa the terainal. Any 
existing file with the saae identifiers as those specified 
on any of the READ cards is erased. Each READ control card 
ends the file preceding it# and the last file is ended by 
the end~of~file indication by the reader. 


CLREADCD 00022 
CLREADCD 00024 
CLREADCD 00025 
CLREADCD 00025 
CLREADCD 00026 
CLREADCD 00028 
CLREADCD 00029 
CLREADCD 00029 
CLREADCD 00030 
CLREADCD 00031 
CLREADCD 00032 
CLREADCD 00033 


Oser card decks aust have been spooled into the user's 
virtual reader before a READCARD coaaand can be issued. The 
user need not be logged in at the tiae the decks are 
transferred to his virtual reader. Decks nay be entered 
separately# and each aust be preceded by an identification 
card (the characters ID punched in coluans 1 and 2 and the 
user's userid starting in coluan 10). CP Eaves the deck 
until the user logs in and reguests it vith a READCARD 
coaaand. If aore than one deck has been read resulting in 
aore than one file in the virtual reader# the decks are 
processed by successive READCARD coaaands in the order in 
which they were entered. 


CLREADCD 00042 
CLREADCD 00043 
CLREADCD 00044 
CLREADCD 00045 
CLREADCD 00046 
CLREADCD 00047 
CLREADCD 00048 
CLREADCD 00049 
CLREADCD 00050 
CLREADCD 00051 
CLREADCD 00052 


specifies the filenaae of the file to be read. An 
asterisk aay be coded in this field. 

specifies the filetype of the file to be read. An 
asterisk aay be coded in this field if fn was 
coded as an asterisk* 


CLREADCD 00059 fn 

CLREADCD 00061 

CLREADCD 00063 ft 

CLREADCD .00064 
CLREADCD 00065 


•- 1 



READCARD | 

( 


r 



) 



READ | 

{ 

fn ft 

1 

fa 

1 

) 



1 



1 

41 

1 

} 



1 

c 


0 . 


j 

1 




{ 

* 




} 

I 



{ 


r 


i 

i 




( 

* * 

1 

fa 

1 

} 



1 

c 


1 

hi 

1 

) 



1 

l 


L 


j 




ft - ---.... _ _—. _i 
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CLREADCD 00*67 fa specifies the fllemode of the file tc be read. If 

CLREADCD 00*69 - this field is omitted, A1 is assumed. 


CLREADCD 00074 Z2ia§ o£ ihe &£A££Mfi Parameters 


CLREADCD 00*77 1. If filename and filetype are specified with the 
CLREADCD 00*79 READCARD command, only one file is read in. 

CLREADCD 00C82 2. If the file designations are to be entered in the card 
CLREADCD 00083 stream, a single asterisk must be specified with the 
CLREADCD 00084 READCARD command. If this term cf the command is 
CLREADCD 00085 specified, and the first card in the input stream is 
CLREADCD 00086 not a valid READ control card, a file named READ CKSUT1 
CLREADCD *0087 At is set up to contain all data read until a valid 
CLREADCD 00088 READ control card is encountered. 

CLREADCD 00091 3. Two asterisks accept the filename and filetype frem the 
CLREADCD *0092 card deck, but use a filemode of Al. 

CLREADCD 0**95 
CLREADCD 00096 
CLREADCD 00097 


4. Two asterisks with a mode specified accept the 
identifiers from the card deck, but use the filesede 
specified* 
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CLREADCD 

CLREADCD 

CLREADCD 

r> r opinrn 

00106 

00107 

DO 108 
00109 

i- 

1 t 

| Coluanj 

Nuaber of | 1 

Characters!Contents! Meaning 

—i 

L L l\ u A [J v U 







CLREADCD 

00110 

1 1 

1 

1 

is 

(Identifies card 


CLREADCD 

00111 

1 

I 


1 

(as a control card 


CLREADCD 

00112 

1 

1 


1 

1 


CLREADCD 

00113 

! 2-5 

1 

4 

| READ 

(Identifies card as 


CLREADCD 

00114 

1 

1 



|a READ control card 


CLREADCD 

00115 

1 

1 


1 

1 


CLREADCD 

00116 

| 6-7 

1 

2 

|blank 

1 


CLREADCD 

001 17 

| 8-15 

1 

8 

|fnaae 

jfilenaae of the 


CLREADCD 

00118 

I 



1 

(file punched 


CLREADCD 

00119 

I 

1 


1 

1 


CLREADCD 

00120 

1 16 

I 

1 

1 blank 

1 


CLREADCD 

00121 

117-24 

1 

8 

j ftype 

(filetype cf the 


CLREADCD 

00122 

1 

1 



|file punched 


CLREADCD 

00123 

1 

1 


1 

I 


CLREADCD 

00124 

|25 

1 

1 

|blank 

1 


CLREADCD 

00125 

126-27 

1 

2 

1fnode 

(fileaode of the 

5 

CLREADCD 

00126 

1 

1 


5 

ifile punched 


CLREADCD 

00127 

1 

1 


1 

1 


CLREADCD 

00128 

i 28 

1 

1 

| blank 

1 


CLREADCD 

00129 

J29-34 

1 

6 

|volid 

llabel of the disk frca 


CLREADCD 

00130 

1 

1 



(which the file was read 


CLREADCD 

00131 


1 


1 

1 


CLREADCD 

CO 132 

| 35 

1 

1 

1 blank 

1 


CLREADCD 

00133 

J36-43 


3 

|an.ddt 

yyjthe date that tie file was 


CLREADCD 

00134 

1 

! 


1 

1 last written 


CLREADCD 

00135 

1 

1 


1 

1 


CLREADCD 

00136 

)44 


1 

|blank 

1 


CLREADCD 

00137 

145-52 

1 

8 

( hh.aa. 

ss|the tine of day that the 


CLREADCD 

00138 

1 

i 


1 

(file was written to disk 


CLREADCD 

00139 

S 

1 


1 

1 


CLREADCD 

0014D 

153-80 

1 

28 

|anything f 



00141 

D . _ 





_j 

v* Ld ntjft u vU 







CLREADCD 

00147 

Figure 

26 

. Foraat 

of the READ Control Card 



CLREADCD 

00150 

Responses 

CLREADCD 

CLREADCD 

00154 

0 0156 

After the cooaand READCARD *, control cards encountered in 
the input card streaa are typed at the terniral. 

CLREADCD 

00158 

DMSRDC701I NULL FILE 

:lreadcd 

CLREADCD 

00159 

D0160 

The spooled card reader contains no fileE for the user 
issuing the READCARD coaaand 

CLREADCD 

00162 

DNSRDC702I READ CONTROL CARD IS MISSING. FCUCHISG ASSUME C: 
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CLREADCD 

CLREADCD 

CLREADCD 

CLREADCD 

clreadcd 

CLREADCD 


H0166 READ BEADCABD CMS0T1 A1 

o o168 The first card in the deck is not a EE ADC ABC central card. 

00170 Therefore the file READ CNSOTt A1 is created. 

00172 DMSRDC738I RECORD LENGTH = ‘Min* BYTES 

00174 The records being read are not 80 oytes lerg; this aessage 
00175 gives the length. 


CLREADCD 00177 
CLRELEAS 00001 


when a READCARD control card is encountered, the first >43 
coluans of tne card are typed to the terainal. 
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CLHELEAS 00008 RSUA.5S 


CLRELE AS 00010 The RELEASE coaaand frees an active disk when the user no 
CLRELEAS 00011 longer needs it. An ACCESS connmnd Bust have been previously 
CLRELEAS 00012 entered for the specified disk. 

CLRELEAS 00014 
CLRELEAS 00015 
CLRELEAS 00018 
CLRELEAS 00019 
CLRELEAS 00020 

CLRELEAS 00025 ecu specifies the virtual device address cf the disk 
CLRELEAS 00026 that is to be released. 

CLRELEAS 00030 node specifies the aode of the disk to be released. 

CLRELEAS 00032 Mote : If a disk is accessed aore than once, the RELEASE ecu 
CLRELEAS 00033 fora of the coBaand will cause all instances cf ecu to be 
CLRENAME 00001 released. The systen disk cannot be released. 
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CLRENAME 00010 ILEJUfll 


CLRENAME ^0012 
CLRENAME 00013 
CLRENAME 0C015 


The RENAME command is used to change the tile identifier cf 
one or aore files. The RENAME command may not te used on a 
file which is located on a read/only disk. 


CLRENAME 00017 
CLRENAME 0C018 

CLRENAME 00019 
CLRENAME 00020 
CLRENAME 00^21 
CLRENAME 00022 


I ! r if i I 

I RENAME | fileidl fileidN | (TYPE ) | | (UPDI£2) I I 

t R | I (NOTI££) | | (NOOPEIRT) | | 

II L J l J | 


CLRENAME 00028 
CLRENAME 00029 
CLRENAME 00030 
CLRENAME 00030 
CLRENAME 00031 
CLRENAME 00033 
CLRENAME 00034 
CLRENAME 0"034 
CLRENAME 00035 
CLRENAME 00036 


fileidl 


specifies the original tile identi 1 icaticn cf 
the file whose name is to te changed. All 
components of the fileid (filename, filetype, 
and filemode) must be coded, either with a name 
or an asterisk. If an asterisk is ceded in any 
field it indicates that any fileid which 
satisfies the other qualificeticnr will he 
renamed. For example, if fileid is ceded as A * 
A1, all files on the A disk with a filename of A 
will be renamed. 


CLRENAME 

CLRENAME 

CLRENAME 

CLRENAME 

CLRENAME 

CLRENAME 

0 n a 3 g 
00039 
0004 1 
0 r '042 
00^43 
00044 

fileidN 

CLRENAME 

00047 

OEUons 

CLRENAME 

00051 

TYPE 

CLRENAME 

00053 

none 

CLRENAME 

CLRENAME 

0 00 54 
00055 

T 


specifies the new file identificaticn of the 
file. All components of the fileid (filename, 
filetype, and filemode) must be coded, either 
with a name or an equal sign. If an equal sign 
is coded, tne corresponding fileid field is left 
unchanged. 


specifies that the new identifiers of ail files 
renamed are to be typed at the terainal. Typing 
takes place only when an * appears in the 
fileid. 


CLRENAME 00059 
CLRENAME C0061 
CLRENAME 00063 


NOTY££ 

none 

NOT 


specifies that the 
files renamed are 
terminal. 


new file idertifiers or all 
not to be typed at the 


CLRENAME 00066 

CLRENAME 00063 
CLRENAME 00^69 


SE2I5S 

none 

OP 


specifies that the user's file directory is to 
updated upon completion of this command. 


CLRENAME 

00^72 

NOOPDI 8 T 

CLRENAME 

00074 

none 

CLRENAME 

00077 

NOOP 

CLRENAME 

00079 


CLRENAME 

00080 



specifies that 
to be updated 
Normally, user 
the completion 
disk files. 


the user's file directory is net 
upon completion of this command. 

file directories are updated at 
of each CMS command that affects 


CLRENAME 


CLRENAME 

CLRENAME 

CLRENAME 

CLRENAME 

CLRENA HE 
CLRUN 
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0008* ILSS22M22 


00086 xxxxxxxx xxxxxxxx xx 

00089 The TYPE option has been specified and an asterisk appears 
00090 in the fiieid. The new filenaoe, filetype, and filemode cf 
00091 each file altered is typed. 

00092 If fileidN is the naae of an existing file, an error message 

00001 is generated. 
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CLRUN 

00011 




:lrun 

" 0 " 14 

• RUN i 

s 

used to initiate an automated secies of functions cn 

:lrun 

"0015 

a fil 

e. 

RUN is capable of coapiling# icadi eg, and starting 

CLRUN 

00016 

ex ecu 

tion of the specified file# depending upon the 

CLRUN 

C 00 1 8 

filet 

ype. The acceptable filetypes are EXEC# MODULE# TEXT, 

CL RUN 

00019 

and 

those required by the language processors. The HUN 

CLRUN 

0 O "20 

coma 

nd 

is actually an EXEC procedure and if it is executed 

CLRUN 

90023 

froa 

within an EXEC file, it must be preceded ty the EXtC 

CLRUN 

0 0"21 

coonand 

naaa. 

CLRUN 

O 0 O 2 J 

i- 

— 

— -- , 

CLRUN 

00024 

I RUN 

1 

fn [ft [fa]] C (args...) ] » 

CLRUN 

00025 

i_ 

— 

j 

CLRUN 

00"31 

f n 


specifies the filename of the file tc be 

CLRUN 

00033 



aanipulated. This field must be entered. 

CLRUN 

00035 

ft 


specifies the filetype of the file to be 

CLRUN 

00036 



Manipulated. If filetype is net specified, a 

CLRnN 

00037 



search is aade for a file with the specified 

CLRUN 

00038 



filenaae and the filetype cf (search to be 

CLRUN 

"00 39 



perforaed in this order): EXEC# MOIULE# TEXT. If a 

CLRUN 

0 0"39 



filetype is specified which is cne required as 

CLRUN 

00040 



input to a language processor, the respective 

CLRUN 

00041 



processor is invoked to compile the source cede 

CLRUN 

00042 



included in the file and to produce a TEXT file. 

CLRUN 

00043 



LOAD and STABT are then called tc initiate program 

CLRUN 

00044 



execution. The filetype must be specified if 

CLRUN 

O0045 



fileaode is specified. Valid filetypes and actions 

CLRUN 

0C046 



perforaed on the specific filetype for this 

CLRUN 

00047 



coaaand are: 

CLRUN 

00051 



EXEC The file is assumed to contain cne 

CLRUN 

00052 



or aore CMS comaands and the EXEC 

CLRUN 

00054 



processor is called to process the file. 

CLRUN 

0C"57 



NODULE The file is assumed to be one created by 

CLRUN 

00057 



the 6ENM0D command. It must have an 

CLRUN 

0 00 58 



entry point with tne same name as fn. 

CLRUN 

C 0 0 5 9 



LOADMOD is called to lead the program 

CLRUN 

00059 



into main storage and START is called to 

CLRUN 

00060 



begin execution of the program at the 

CLRUN 

00061 



entry point equal to fn. 

CLRUN 

00064 



TEXT The file is assumed tc contain 

CLRUN 

O0C64 



relocatable object code as prcitced by 

CLRUN 

00065 



the language processors. It must have an 

CLRUN 

00066 



entry point with the same name as fn. 

CLRUN 

00066 



LOAD is called to bring the file into 

CLRUN 

"0067 



aain storage in an executable format and 

CLRUN 

00068 



START is called tc execcte the program 

CLRUN 

00C69 



beginning at the entry point named by 


1SS 
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CLRUN 

00070 

clrun 

0C075 

CLRUN 

00^76 

CLRUN 

00077 

CLRUN 

00078 

CLRUN 

00080 

CLRUN 

00083 

CLRUN 

00084 

CLRUN 

n0085 

CLRUN 

00C86 

CLRUN 

00087 

CLRUN 

00088 

CLRUN 

00089 

CLRUN 

00090 

CLRUN 

00^91 

CLRUN 

00091 

CLRUN 

00092 

CLRUN 

00093 

CLRUN 

00094 

CLRUN 

00095 

CLRUN 

00096 

CLRUN 

00096 

CLRUN 

00098 

CLRUN 

00099 

CLRUN 

00100 

CLRUN 

00101 

CLRUN 

00102 

CLRUN 

00103 

CLRUN 

00104 

CLRUN 

00105 

CLRUN 

00105 

CLRUN 

00106 

CLRUN 

n 01Q7 

CLRUN 

00108 


£m 


acgs 


fn. 


specifies the fileaode 

manipulated. If this 
filetype must be spec 

specified, the default 
search the user's disks f 


of 

the 

file tc 

be 

ield 

is 

specified. 

a 

fied. 

If 

t o is 

net 

earch 

order 

is used 

tc 

r the 

file. 




are one or aore user arguments tc be tsed during 
execution. If compiling or loading is to be 
performed, the default options for there functions 
are assumed. The user nay specify up tc thirty 
arguaents in the RUN command, provided they fit cn 
a single input line. These arguments are used 
during operation of an EXEC file, ci during 
execution of a MODULE or TEXT file. The arguments 
are set up as a string of dcuklewords, one 
argument per doubleword. The address of this 
string is passed to the specified file at 
execution time. Each argument is left-justified, 
and any argument aore than eight characters leng 
is truncated on the right. With an EXEC file, any 
arguments specified in the RUN ccmiand replace the 
corresponding &n operands in the individual 
commands of the EXEC file. 


With a file whose filetype is other than EXEC, the 
arguaents are placed in a string as described 
above. The address of the string nay tc obtained 
by adding 8 to the address contained in general 
register 1 at the time execution cf the specified 
prograa begins. Additional arguments may be 
obtained by using displacements of 16, 24, 32, and 
so forth, from the address thus obtained until a 
hexadecimal 'FF* is encountered as the first byte 
of an arguaent field. This signals the end of the 
arguaent list. 
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CLSET 00004 551 


CLSET 00006 The SET command is used to establish, turn c££, or reset a 
CLSET 00007 particular function of the user’s virtual machine. Only ere 
CLSET "9908 function may be specified per SET command. 


CLSET 00012 Note: If the function is one of those performed ty the CP 
CLSET "0912 SET command, CMS will pass the command input to the control 
CLSET 00013 program for processing. 

CLSET 00024 ,-t 

CLSET 00025 j SET j function I 
CLSET 00026 J | I 
CLSET 00027 j | fMSlioSS: [BLIP {stringt (count) ] |CN|CFF}] | 
CLSET OOC20 II [HDYMSG (SMSG)LMSG) ] I 
CLSET 00029 I j [LDRTBL5 [nnJJ | 
CLSET 00030 | j [ RELPAGE (ON|OFF)J | 
CLSET 00031 j 1 [INPUT [a XXJ ] | 
CLSET "0032 J | [OUTPUT [ XX a] ] | 
CLSET 00033 | j [ABBREV {ON|OFF}J | 
CLSET 00034 | J [ REDTYPE {ON|OFP}J | 
CLSET 00035 | | [IMPEX (ON|OFF)] | 
CLSET 000 36 | | [ IMPCP (ON|OFF}J | 
CLSET 00037 | | (PROTECT (ON|OFF)] I 
CLSET 00C38 •-J 





SET j 

i 

function 




1 

i 

faasliaas: 

[BLIP {stringt (count) ] |CN|CFF}] 



i 


[RDYMSG (SMSG | LMSG) ] 



s 


[LDRTBLS [nnJJ 



i 


[RELPAGE {ON| OFF) ] 



i 


[INPUT [a xx j ] 



i 


[OUTPUT [ xx a J ] 



i 


[ ABBREV {ON |OFF) J 



i 


[ REDTYPE {ON j OFF] J 



i 


[IMPEX (ON| OFF) ] 



i 


[ IMPCP (ON | OFF) ] 



i 


[PROTECT (O N | OF F) ] 





CLSET 00043 Func tio ns 


CLSET 00048 BLIP string[ (count) J 

CLSET 00048 

CLSET 00049 

CLSET 00049 

CLSET 00049 

CLSET 00050 

CLSET 00051 


CLSET 00054 ON 

CLSET 00C54 

CLSET 00055 

CLSET 00058 OFF 

CLSET 00060' RDYMSG LMSG . 

CLSET 00061 

CLSET 00063 SMSG 

CLSET 00064 

CLSET 00065 

CLSET "0068 LDRTBLS nn 

CLSET 00071 22 


defines the characters which CMS uses 
to notify the CMS user cf e\er> twe CPU 
seconds of real execution time. Up to 
eight characters may be defined, and if 
trailing blames are desired, the count 
field must be used. ON and OFF may not 
be used as BLIP characters. 

returns the detault ELI! cnaracter 
string which is a string of unprintable 
characters. 

turns off BLIP 

provides the user with the standard CMS 
READY message including date ard time. 

provides the user with a shortened form 
of the CMS READY message net including 
date and time. 

The user may change the number (nn) cf 
pages of storage used fer leader tables 


2 C 1 
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CLSET 

00071 



Normally, a virtual machine having from 

CLSET 

00071 



256K to 512K cf addressable main 

CLSET 

00072 



storage has two pages of leader tables; 

CLSET 

00072 



a larger virtual machine has three. 

CLSET 

0007 3 



This number may be changed with SE1 

CLSET 

00073 



LDRTBLS on provided that (1) nn is a 

CLSET 

00073 



decimal number less than 128, and (2) 

CLSET 

00074 



the user has enough storage available 

CLSET 

00C74 



to allow nn pages to be used fer leader 

CLSET 

00074 



tables. If both of these conditions 

CLSET 

00075 



are met, nn pages are set aside for 

CLSET 

00076 



loader tables. 

CLSET 

00079 

BELPAGE 

ON 

When CMS is running in a virtual 

CLSET 

00081 


OPP 

machine, pages of storage are released 

CLSET 

00082 



and set to binary zeroes after the 

CLSET 

0 C 0 8 2 



following commands complete executicn; 

CLSET 

00082 



ASSEMBLE, COBOL*, COPYFILE, CCMEAEE, 

CLSET 

00083 



EDIT, MACLIB, PLIOPT*, SOFT, TAPE, 

CLSET 

00083 



TXTLIB, and UPDATE. This is the normal 

CLSET 

00083 



mode of operation — that obtained by 

CLSET 

00084 



default or when SET FELEAGE CN is 

CLSET 

00084 



specified. However, if a user wishes 

CLSET 

00084 



to examine storage after any of these 

CLSET 

00085 



commands has finished — for example. 

CLSET 

00085 



for debugging or analyzing a problem -- 

CLSET 

00*85 



the command SET RELPACE OFF inhibits 

CLSET 

00087 



this releasing feature. 

CLSET 

00089 

INPUT 

a xx 

translate the specified character (a) 

CLSET 

00089 



to the specified hexadecimal code (xx) 

CLSET 

00090 



upon input from the terminal. 

CLSET 

00092 


(blank) 

return all characters to their default 

CLSET 

00092 



translation upon input frem the 

CLSET 

00093 



terminal. 

CLSET 

00095 

OUTPUT 

xx a 

translate the specified hexadecimal 

CLSET 

00096 



representation (xx) to the specified 

CLSET 

00096 



character (a) upon cutput to the 

CLSET 

0 0097 



terminal. 

CLSET 

00099 


(blank) 

return all characters to their default 

CLSET 

00099 



translation upon input trem the 

:lset 

00100 



terminal. 


CLSET 

CLSET 

09103 
''O 104 

ABBRBV ON 

accept CMS minimum 

abbreviations (trunctiots). 

command 

CLSET ' 

CLSET 

CLSET 

C 9107 
99109 
com 

* COBOL and PLIOPT 
be obtained from 

invoke IBM 
IBB for a 

Program 

license 

Froducts which 
fee. 

may 
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CLSET 

"01 13 


OFF 

CLSET 

^0114 



CLSET 

00116 

BE DT It PE 

ON 

CLSET 

00117 



CLSET 

00117 



CLSET 

00118 



CLSET 

00120 


OFF 

CLSET 

00121 



CLSET 

00123 

IMPEX 

ON 

CLSET 

00123 



CLSET 

00124 



CLSET 

00125 



CLSET 

0 012 7 


OFF 

CLSET 

00128 



:lset 

00129 



CLSET 

"0131 

IHPCP 

ON 

CLSET 

00131 



CLSET 

00132 



CLSET 

"0133 



CLSET 

00135 


OFF 

CLSET 

00136 



CLSET 

CC137 



CLSET 

00141 

PROTECT 

ON 

CLSET 

00141 



CLSET 

00142 



CLSET 

00144 


OFF 

CLSET 

00146 




do not accept CMS Binimum command 
aboreviations (truncticrs). 

CMS ercoc messages will be typeu in 
red, it the terminal is equipped with 
the appropriate terminal feature ana a 
two-color ribbon. 

suppress red printing cf error 
messages. 

EXEC files will be considered commands, 
and can be invoked simply ty entering 
the filename of the EXEC file. This is 
the initial settiug. 

EXEC files are not considered commands. 
To execute an EXEC file, the "EXEc” 
command name must be issued. 

Command names that CMS dees net 
recognize will oe passed tc CP; that 
is, unknown commands will be assumed tc 
be CP commands. 

commands that CMS does net recognize 
generate an error message at the user's 
terminal. 

The CMS nucleus is protected against 
writing being done within its storage 
area. 

The storage area containing the CMS 
nucleus may ba written cn. 
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CLSORT 00005 


CLSORT 00007 
CLSORT 00008 
CLSORT O0009 
CLSORT 00010 
CLSORT O0011 
CLSORT 00011 
CLSORT 00012 
CLSORT 00014 


The SORT command reads fixed length records from a CMS input 
file, arranges then in ascending EBCDIC order according tc 
user-specified sort fields, and creates a new tile 
containing the sorted records. The input aEd output tiles 
nust not have the sane file identifiers, since SCET cannot 
write the sorted output back into the space occupied by the 
file. If a file with the sane name as the output file 
already exists, the old file is erased. 


CLSORT 00022 ( -1 

CLSORT 00023 \ SORT J fn1 ft1 fat £n2 ft2 f«2 | 

CLSORT 00024 '---1 


CLSORT 

CLSORT 

0C030 

09031 

fn 1 

specifies the filename of the file containing 
records to be sorted* 

the 

CLSORT 

CLSORT 

0C034 

00035 

ftl 

specifies the filetype of the file containing 
records to be sorted. 

tna 

CLSORT 

CLSORT 

00C38 

00039 

fal 

specifies the filenode of the file containing 
records to be sorted. 

the 

CLSORT 

CLSORT 

00042 

00043 

fn2 

specifies the filenane of the new output file 
will contain the sorted records 

which 

CLSORT 

CLSORT 

00046 

00047 

ft 2 

specifies the filetype of the new output file 
will contain the sorted records. 

whicn 

CLSORT 

CLSORT 

00050 
00051 ■ 

fa2 

specifies the fileaode of the new output file 
will contain the sorted records. 

which 


CLSORT 

CLSORT 

CLSORT 


00057 

00058 

00059 


Entepinq Sort Con trol 
entered, CMS responds 
terminal typewriter: 


fields: After the SORT command is 
with the following message cn the 


CLSORT 0 0062 DMSSRT604R ENTER SORT FIELDS: 


CLSORT 

9CC64 

CLSORT 

0^65 

CLSORT 

00066 

CLSORT 

00067 

:lsort 

00068 

CLSOR” 

0 0069 

CLSORT 

00079 

CLSORT 

or07i 


The user should respond by typing cne or mere pairs c£ 
nuabers of the fora M xx yy w separated by one cr mere blanks. 
Each xx is the starting character position cf a sort field 
within each input record and yy is the ending character 
position. The leftmost pair of nuabers denotes the major 
sort field. The number of sort fields is United to the 
number of fields the user can key in on one line. The 
records can ba sorted on up to a total of 253 positions. 
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CLSORT 

00075 

clsort 

00076 

CLSORT 

00076 

CLSORT 

00077 

CLSORT 

00078 

CLSORT 

^0079 

CLSORT 

0 0080 

CLSORT 

00081 

CLSORT 

00082 

CLSORT 

00083 

CLSORT 

00087 

CLSORT 

<"*0088 

CLSORT 

nnri92 

:lsort 

00093 

CLSORT 

C 0094 

CLSORT 

00096 

CLSORT 

00098 


CLSORT 

C 0101 

CLSORT 

00102 

CLSORT 

00103 

CLSORT 

oni05 

CLSORT 

0 010 7 

CLSORT 

O0113 

CLSORT 

00114 

CLSORT 

00115 

CLSORT 

00117 

CLSORT 

00121 

CLSORT 

00122 


CLSOBT 

00127 

CLSORT 

00130 

CLSORT 

00133 

CLSORT 

00134 


5aiH_5£2£M§ fi©aiii£eiea£§ £°£_SS££: The sorting operation 
takes place with two passes of the input file. Pass one 
creates an ordered pointer table in the user's virtual 
storage. Pass two uses the pointer table to read the input 
file in a random manner and write the output tile. 
Therefore, the size of storage and the size and number of 
sort fields are the limiting factors in ceteraining the 
number of records that can be sorted at acy one time. An 
estimate of the maximum number of records that can te sorted 
can be made by using the following formula: 

VrtSIl£_ r _ij2K 
NB = 14 ♦ NC 

where NB is the estimated maximum number cf input records; 
NC is the total number of characters in the defined sort 
fields; VMSIZE is the storage size cf the user's virtual 
machine; and K represents 1024 bytes (132K is the size cf 
the resident CMS nucleus). For example: 


i- 1 

| SOBT j NAME ADDRESS A1 SORTEDNA ADDRESS B1 | 

»-;_j 

DMSSRT604R ENTER SORT FIELDS: 

1 10 25 28 

The records in the file NAME ADDRESS are sorted cn positions 
1-10 and 25-28* The sorted output is written into the newly 
created file SORTEDNA ADDRESS. If the user has a 32GK 
virtual machine he can sort a maximum cf 6675 records. 

NR * 14 ♦ NC * 14 ♦ 14 = 28 = 28 = 6875 


Resp o n ses 


DMSSRT604R ENTER SORT FIELDS: 

The user is reguested to enter SORT control fields. He 
should enter them in the form described above. 
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CLSTART 

00006 

CLSTART 

00008 

CLSTART 

00009 

CLSTART 

00010 

CLSTART 

00021 

CLSTART 

00022 

CLSTART 

00023 

CLSTART 

00024 

CLSTART 

00025 

CLSTART 

00026 

CLSTART 

00031 

CLSTART 

00032 

CLSTART 

00033 

CLSTART 

00033 

CLSTART 

00034 

CLSTART 

00035 

CLSTART 

00037 

CLSTART 

00038 

CLSTART 

C0039 

CLSTART 

00039 

CLSTART 

00040 

CLSTART 

00040 

CLSTART 

00041 

CLSTART 

00041 

CLSTART 

00042 

CLSTART 

00042 

CLSTART 

00043 

CLSTART 

00045 

CLSTART 

00046 

CLSTART 

00046 

CLSTART 

00046 

CLSTART 

00047 

CLSTART 

00047 

CLSTART 

00048 

CLSTART 

00048 

CLSTART 

00049 

CLSTART 

00049 

CLSTART 

00050 

CLSTART 

00050 

CLSTART 

00051 

CLSTART 

00054 

CLSTART 

00055 

CLSTART 

00055 

CLSTART 

00056 

CLSTART 

00056 

CLSTART 

00057 


51 All 


START begins execution of programs that have been previously 
loaded, and passes the address of a string of user arguments 
to that program. # 

»- 1 

I it— I 

| START | | (entry} £args.».]| | 

I lilt) 1 I 

II 1 - — 1 I 

I_;_i 

specifies the name of a control section or entry 
point to which control is passed at execution 
time. Entry must be a control section name cr an 
entry point name. It may be a filename only if 

the filename is identical to a ccnticl section 
name or an entry point name. 

specifies that control is to be passed to the 
default entry point. If nothing is coded in this 
field this is the default. The default entry 
point is either the address specified in the 
operand field, of the first END card containing 
a non-blank operand field, or the beginning of. 
the first file loaded if all END cards in the 
TEXT files contain blank operand fields. The 
default entry point can be changed fcy issuing 
the INCLUDE-BESET option when loading additional 
files. 

args... specify information to be passed to the started 

program. If user arguments are specified, entry 
or * must be specified; otherwise, the first 
argument is taken as the entry point. Arguments 
are passed to the program via general register 
1. The entry operand and any argunects are set 
up as a string of doublewords, cne argument per 
doubleword, and the address of the list is 
placed in general register 1. The arguments are 
obtained by using displacements of 6, 1b, 24, 

and so forth, from the address contained in 
register 1, when execution of the specified 
program begins. 

Note ; Any undefined names or references specified in the 
files loaded into storage are defined tc lccaticn zero. 
Thus, if there is a call or branch to a subroutine from a 
main program and the subroutine has never been leaded, the 
call, or branch transfers control to location zerc of the 
users virtual machine at execution time. 


entry 
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CLSTAHT 

CLSTART 

CLSTART 


00060 £saE2BS§§ 

00063 M EXECUTION BEGINS* «»** 

00065 is typed when the designated eutcy point is \alicated. 
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CLST&TB 00006 STAT E 


CLSTATE 00009 The STATE coaaand verifies the existence of a CMS file. 

CLSTATE 00018 ,-, 

CLSTATE 00019 | STATE | fn ft [fa] | 

CLSTATE 00020 «-* 

CLSTATE 00025 fn specifies the filenaae of the file whose existence is 

CLSTATE 00026 to be verified. This field Bust be specified. 

CLSTATE 00028 ft specifies the filetype of the file whose existence is 

CLSTATE 00029 to be verified. This field aust be specified. 

CLSTATE 00031 fa specifies the fileaode of the file whose existence xs 

CLSTATE 00032 to be verified. If this field is caitted, all user 

CLSTATE 00033 disks will be searched. 

CLSTATE 00035 If * is specified for fn, ft and/or fa the first file 

CLSTATE 00037 found satisfying the rest of the fileid is used. 


CLSTATE 00039 Besponses 


CLSTATE 0O040 When STATE is issued for an existing file, the conmand 
CLSTATE 00041 returns with the BEADY Message; otherwise, an errcc aessage 
CLSVCTRA 00001 is returned. 
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CLSVCTRA 00004 £iQ18ih£Z 


CLSVCTRA 00^06 
CLSVCTRA 00007 
CLSVCTRA 00008 


The SVCTRACE command is used to trace and record information 
about Supervisor Calls which occur in tne sjsten tinning in 
the user's virtual machine. 


CLSVCTRA 00009 
CLSVCTRA C0C11 
CLSVCTRA 00012 
CLSVCTRA 00013 
CLSVCTRA 00014 
CLSVCTRA 00014 
CLSVCTRA 00016 


The information recorded will include the main storage 
location of the calling SVC instruction and the name ci the 
called program or routine; the normal and error return 
addresses; the contents of the general anc flcating-pcict 
registers before branching to the SVC-called program and 
after returning from it, and 16 words of the parameter list 
which existed when the SVC was issued. 


CLSVCTRA 99 r 17 
CLSVCTRA O'ICIB 
CLSVCTRA 00019 
CLSVCTRA 00020 
CLSVCTRA 00^21 
CLSVCTRA 00^21 
CLSVCTRA C0 n 22 
CLSVCTRA 00023 
CLSVCTRA 00C24 
CLSVCTRA 00024 
CLSVCTRA 00025 
CLSVCTRA 99026 


To terminate tracing previously established by the SVCTRACE 
command, the user may issue one of the CMS commands, HC cr 
SVCTRACE OFF. Both SVCTRACE OFF and HO cause all trace 
information recorded up to the point they are issued to be 
printed on the virtual spooled printer. SVCTRACE OFF can be 
issued only when the keyboard is unlocked to accept input to 
the CMS command environment. To terminate tracing at any 
other point in system processing, HO must be issued. Ii a 
user issues the CMS command HX or logs out from the control 
program before termination of tracing set by SVCTFACE, the 
switches are cleared automatically and all recorded trace 
information is printed on the virtual spooled printer. 


CLSVCTRA 0C036 ,--, 

CLSVCTRA 00937 J SVCTRACE | (ON ) | 
CLSVCTRA 9n038 | SVCT J (OFF} I 
CLSVCTRA n 0°39 «------» 


CLSVCTRA 00045 ON 
CLSVCTRA 00C47 


specifies that tracing of all SVC instructions 
issued within CMS is to commence. 


CLSVCTRA 09050 OFF 


specifies that tracing is to be 


discontinued. 


CLSVCTRA 00052 
CLSVCTRA 09054 


Note : The printer trace output will ccrsist cf the 

following: 


CLSVCTRA 00958 
CLSVCTRA 90958 
CLSVCTRA 00^59 


* the contents of the general registers both before the 
SVC-called program is given control and aftei a return 
frcm that program. 


CLSVCTRA 00061 
CLSVCTRA 90063 


the contents of the general registers when the SVC 
handling routine is finished with processing. 


CLSVCTRA 99065 
CLSVCTRA 99966 
CLSVCTRA 99067 


• the contents of the floatitig-point registers before the 
SVC-called program is given control and after a return 
frcm that program. 
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CLSVCTRA' 00070 

• the 

contents of the floating-point registers when the 

SVC 

CLSVCTRA 

00071 

handling routine is finished processing. 


CLSVCTRA 

00074 

• the 

paraaeter list passed to the SVC. 


CLSVCTRA 

00077 

BaS£gB5g3 


CLSVCTRA 

CLSVCTRA 

CLSVCTRA 

00079 

00087 

00088 

The format of the first line of trace output is as fcllcws: 

r i 

1 - 1 

CLSVCTRA 

CLSVCTRA 

CLSVCTRA 

00089 

00090 

00091 

1 ♦ 1 

1 * 1 

i j 

N/D * xxx/dd naae FROM loc OLDPSW = pcwl GCPSH = 

psw2 

CLSVCTRA 

00096 

- 

information before processing of the SVC trace. 


CLSVCTRA 

00099 

♦ 

infornation after processing of the SVC. 


CLSVCTRA 

00102 

* 

coaplete before and after tracing. 


CLSVCTRA 

00105 

XXX 

SVC nuaber. 


CLSVCTRA 

00108 

dd 

nesting level of SVC call. 


CLSVCTRA 

00111 

name 

naae of the aacro dr routine being called. 


CLSVCTRA 

noi14 

loc 

program location from which the SVC was issued. 


CLSVCTRA 

00117 

pawl 

PSH at tiae of SVC invocation. 


CLSVCTRA 

CLSVCTRA 

00120 

00122 

psw2 

before—PSH with which the SVC is invoked. 
after-PSW which returns control to the user. 


CLSVCTRA 

00125 

rc 

return code passed froa the SVC handling routine 

via 

CLSVCTRA 

00126 


general register 15. 



rc 
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CLSYNO 00004 £1112 MIS 


CLSYNO 00006 
CLSYNO 0 00-37 
CLSYNO 00009 


The SYNONYM command allows the user to specify his cun 
command names to be used with, or in place of the standard 
CHS command names. 


CLSYNO 00009 
CLSYNO *9010 
CLSYNO '■'0019 
CLSYNO 00011 
CLSYNO 00012 


User-defined names may be used either instead cf, or in 
conjunction with the standard CMS system abbreviations—that 
is, the synonym command permits the user to modify the 
coamand names to make them acceptable in his own 
environment. 


CLSYNO 00021 
CLSYNO 00022 
CLSYNO 00023 
CLSYNO 00024 
CLSYNO 00025 
CLSYNO 00026 


i-1 

I SYNONYM [ [[ fn [ft [ fmJJ] [ (options,.. ) ]] | 

j si 19 | | 

J I ^Elisas: csiuinostd] i 

I ! [CLEAN] | 

t— ---j 


CLSYNO 0*031 fn 
CLSYNO 00033 


specifies the filename of the user file which 
contains the user-defined synonyms. 


CLSYNO 00037 ft 
CLSYNO 00038 
CLSYNO 00*39 
CLSYNO 00*40 


specifies the fiietype of the user file wnich 
contains the user-defined synonyms. The 
fiietype must be SYNONYM; if omitted, SYNONYM is 
assumed. 


CLSYNO 00043 fm 
CLSYNO 00044 
CLSYNO 00045 


specifies the filemode of the user file which 
contains user-define synonyms. If emitted, all 
user disks are searched for the file. 


CLSYNO 00047 
CLSYNO 00048 
CLSYNO 00049 


Note; If no file identifier is specified, nc user-defined 
synonyms are established and CHS abbreviations are used in 
the manner defined by the options. 


CLSYNO 

00052 

QEtiSfls 

CLSYNO 

00054 

STD 

CLSYNO 

00055 

CLSYNO 

00060 

NO STD 

CLSYNO 

00063 

CLEAR 

CLSYNO 

CC064 



specifies that standard CMS abbreviations are tc 
be used. 

standard CMS abbreviations are net to be used. 

removes any synonym taule set ty a previously 
entered SYNONYM coamand. 
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CLSYMO 

CLSYNO 

CL5YN0 

CLSYNO 

00068 

00069 

00070 

00071 

Note: The user's SYNONYM file consists of 80-byte 
fixed-length records in free-fora fornat with ccIukqs 73-80 
ignored. Its filetype aust be SYNONYM. The fcraat for each 
record is 

CLSYNO 

CLSYNO 

CLSYNO 

CLSYNO 

00073 

00074 

00075 

00076 

--— — i 

| system—command) user—synonya| count | 

1 1 II 

i— _ j 

CLSYNO 

CLSYNO 

CLSYNO 

CLSYNO 

CLSYNO 

CLSYNO 

CLSYNO 

00081 

00082 

00082 

00083 

00084 

00085 

00086 

where count is the nininua number of characters that Bust be 
entered for the synonym to be accepted by CMS. If emitted, 
the entire synonya aust be entered (see the exaaple below). 
A table is built from the contents of this file tc use for 
command synonyms. The user aay have several SYNONYM files 
but only one aay be active at any one time. For example, if 
the synonya file contains: 

CLSYNO 

00088 

MOVEFILES MVIT 

CLSYNO 

CLSYNO 

CLSYNO 

00089 

0 0090 
0O091 

The synonya MVIT aay be entered as a command name tc execute 
the MOVEFILE command. It aay not be abbreviated since nc 
count is specified. 

CLSYNO 

00094 

ACCESS GETDISK 3 

CLSYNO 

CLSYNO 

00096 

00097 

The synonyas GET, GBTD, GETDI, GETDIS, or GETDISK aay be 
entered as the coaaand name instead of ACCESS. 


CLSYNO 

00100 

Responses 



CLSYNO 

03102 

DMSSYN711I 

NO SYSTEM SYNONYMS IN 

EFFECT 

CLSYNO 

00104 

No synonyas 

have been defined for 

the system. 

CLSYNO 

00106 

DHSSYN712I 

NO SYNONYMS (DMSINA NOT IN NUCLEIS) 

CLSYNO 

CLTAPB 

00107 

C0P01 

The system routine which handles 
in the systea. 

SYNONYM prccessing 
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CLTAPB 

00005 

1ALE 




:ltaps 

00007 

The 

TAPE coaaand 

duaps CMS-foraatted files from disk to 

CLTAPE 

00A08 

tape. 

loads previously dumped files froa tape tc disk 

. a nd 

CLTAPB 

0 0009 

performs various 

control operations on a specified 

tape 

CLTAPB 

00009 

drive 

. TAPE is 

used solely for CMS files; therefore 

, the 

CLTAPE 

0001 1 

files 

On tape are of a foraat unique to CMS. The 

TAPE 

CLTAPE 

0 0011 

coaaand will not 

process aulti-voluae files. Disk files to 

:ltape 

00012 

be duaped aay 

contain either fixed or variatle length 

CLTAPE 

^0013 

records. 



CLTAPE 

0 AO 011 





V'JV4H 

r- 




CLTAPB 

00025 

1 

8 

r t 


CLTAPE 

0 00 26 

| TIPS | { DUMP 

{fn} {ft} | f a | * 

} 

CLTAPE 

00027 

1 

1 ( 

{* i C* ) 1* 1 C (optionA cpticnE) ] 

) 

CLTAPE 

00023 

1 

! ( 

L J 

} 

CLTAPE 

n 0029 

1 

a c ( 

r r n 8 

} 

CLTAPE 

00030 


i { { LOAD 

| {fn} {ft} |fa| U 

i 

CLTAPB 

00031 

1 

a [ ( 

a {* } {* ) 14 1 li 

} 

CLTAPE 

0O032 

1 

a { c 

L L Jij * 

} * 

CLTAPE 

00033 

1 

a ( ( 

} [ (optionB optionC) ] 

} (option!) 

CLTAPE 

00"34 


a t ( 

r i ) 

} 

CLTAPE 

00^35 

1 

i ( { SCAN 

1 {fn} {ft} | } 

i 

CLTAPE 

00036 

1 

1 ( ( 

1 (*}{*} 1 i 

} 

CLTAPE 

00037 

1 

1 ( ( 

L J } 

} 

CLTAPE 

00038 

1 

j { ( SKIP 

{fn} {ft} ) 

} 

CLTAPE 

or>039 

1 

1 C ( 

{*){*} ) 

) 

CLTAPB 

00040 

1 

1 c 


) 

CLTAPE 

00041 

1 

| ( MODESBT 

i 

CLTAPE 

0 0C 4 2 


1 ( 

r i 

> 

CLTAPE 

00043 


| ( tapead | n | 

) 

CLTAPE 

00044 


a t 

Hi 

} 

CLTAPE 

00045 

1 

1 l 

L J 

i 

CLTAPE 

00046 

1 

1 



CLTAPE 

00047 

1 

| optionA: 

f HTM t NOHTM1 


CLTAPE 

C r 048 

1 




CLTAPE 

00049 


| optionB: 

[ NOPHINT|PBINT | TERM | DISK ] 


CLTAPB 

00050 

1 




CLTAPE 

00051 

1 

| optionC: 

[ EOF n | EOT J EOF J ] 


CLTAPE 

00052 


a 



CLTAPE 

00053 


1 optionD: 

[TAPi|ccu|TAPll 1813 


CLTAPE 

00054 

1 


[7THACK | 9TRACK J 


CLTAPE 

00055 


1 

[DEN {200| 556| 80011600} j 


CLTAPE 

00O55 

1 


[TRTCH { 0 1 OC JOT J E) ET} } 


CLTAPE 

00057 


a 



CLTAPE 

00058 

1 

J tapead: 

[BSFIBSRjEHGjFSFjFSR)REW |RUN|WTP ] 


r* T T* A D I? 


8_ 




u I A r *5 

CLTAPB 

V vWDs 

00065 

* These parentheses are not used if option D is selected. 

CLTAPE 

00068 

f n 

specifies the filenaae of the files upon 

which 

CLTAPE 

00070 


the indicated operations are to te pettoraeu. 


2 1 3 







IBH CONFIDENTIAL 


CLTAPB 

CLTAPE 

CLTAPE 

CLTAPE 


CLTAPE 


CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPB 

CLTAPB 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPB 

CLTAPE 

CLTAPE 

CLTAPE 


00072 

00074 

ft 

specifies the filetype of the files upon which 
the indicated operations are to te performed. 

00076 

00078 

fa 

specifies the filenode of the files upon which 
the indicated operations are to fce performed. 

00081 

Functions 


00085 

00087 

00088 

O0089 

DO HP 

The DUMP function duaps one or sore disk files 
to tape. The file identifier aust be specified. 
If an asterisk is coded for fn cr ft, all files 
which satisfy the resulting fileid are duaped. 

"0091 

"0093 

00093 

O0094 

00095 

09096 

00096 

00097 

00098 

00099 

LOAD 

The LOAD function writes tape flies fc disk. If 
a fileid is specified, only that cne file is 
loaded. If the option EOF n is specified and no 
file identification is entered, n tape files are 
written to disk. If an asterisk (*) is specified 
for fn or ft, all files within EOF n which 
satisfy the resulting file identifer are loaded. 
The files are written to the disk indicated by 
the aode letter. The aode number if entered, is 
ignored. 

00102 

00103 

00104 

00105 

09106 

09197 

09107 

09108 

SCAN 

The SCAN function types to the terninal (unless 
NOPBINT, PRINT or DISK is specified) the names 
of the files on tape. If DISK is specified the 
list of file identifiers is written tc a file 
naaed TAPE NAP. If a fileid is specified, 
scanning stops upon encountering that file. If 
not specified, scanning occurs over n tape oiarks 
as specified by the option EOF n. 

00111 
09111 
09112 
90113 
00113 
99114 

SKIP 

The SKIP function positions the tape at a 
specified point, depending upon other options 
and parameters. If fileid is entered, the tape 
is positioned after the specified tile; if iOF n 
is entered, the tape is positioned after n tape 
aarks. 

C 9117 
00120 

0 " 1 21 
00122 

nODESET 

NODE 

specifies that the values set by the DEN, TRACK 
and THTCd options described belcw are to remain 
in effect for the specified tape until they are 
changed in a subsequent TAPE ccmiand. 

09125 

00128 

tapcad n 

1 

specifies a tape control function to te executed 
n tiaes (default is 1 if u is not specified) : 

00139 

09131 

00132 


BSF backspace n tape marks 

BSB backspace n tape records 

EB6 erase gap 
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CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 


CLTAPE 


.cltape 

.CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 

CLTAPE 


00133 

PSP 

00134 

FS R 

00135 

RES 

00136 

HUN 

00137 

WT H 


forward space o tape Barks 
forward space n tape records 
rewind tape to lead (cint 
rewind tape and unload 
write n tape sarks 


00145 



00147 

*0148 

WTH 

specifies that a tape mark is tc be written cn 
the tape after each file dumped. 

00150 

00152 

NOWTfi 

specifies that no tape mark is to be written cn 
the tape upon completion of the LUMF function. 

00155 

00157 

00158 

NOPRINT 

NOPR 

speicifes that no spool print record is to be 
built suanarizing the files operated cn during 
the DUMP function. 

00161 

*0164 

ISM 

T 

specifies that a list of files operated on is to 
be typed out at the user's terminal typewriter. 

00167 

00170 

PRINT 

PR 

specifies that the list of files operated on is 
to be spooled to the printer. 

00172 

*0173 

00174 

00175 

DISK 

specifies that a disk file is tc be created 
containing the list of files operated on by the 
DUMP operation. The disk file has a file 
identifier of TAPE MAP. 

*0177 

00179 

EOT 

indicates that tape reading should continue 
until end-of-tape indicaticn is received. 

*0181 

00182 

*0183 

EOP n 

indicates that tape reading should continue 
through a maximum of n tape marks. Default is 

EOF 1. 

00185 

00186 

TA Pi/ecu 

specifies the symbolic tape identification cr 
the actual device address of the tape tc be read 


00187 

00187 

00188 

00189 

0 0191 
0 9192 
00193 

00196 

0*199 
0 0199 


7TRACK 

9TRACR 
DEN nnn 


froa or written to. The default is TAPI/iei. 
The unit specified by ecu aust have previously 
been attached to the user's system before any 
tape I/O operation can be attempted. 

specifies a 7 track tape. Odd parity, data 
convert on and translate off are assuacd unless 
TRTCH is specified. 


specifies a 9 track tape. 

specifies the tape density - 2CC, 556, 
1600 bytes per inch. If 2CC or 


80C r cr 
S5fc is 
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CLTAPE 00200 
CLTAPE 00201 
CLTAPE 00201 
CLTAPE O0202 


specified, 7TRACK is aaauaed. If 1600 la 

specified, 9TRACK is assuaed; if BOO is 

specified, 9TRACK is assuaed utless 7TRACK is 
specified. 


CLTAPE 

00205 

TRTCH xx 

CLTAPE 

00205 


CLTAPE 

00207 


CLTAPE 

00208 



specifies the tape recording techriyue for 7 
track tape. If TRTCH is specilied, 7TKACK is 
assuaed. One of the following mcst be specified 
as xx: 


CLTAPE 

00214 

0 - odd 

CLTAPE 

00217 

OC - odd 

CLTAPE 

00222 

OT - odd 

CLTAPE 

00224 

E - even 

CLTAPE 

00225 

off 

CLTAPE 

00226 

ET - even 

CLTAPE 

00227 

off 


parity, data convert off, translate off 
parity, data convert on, translate off 
parity, data convert off, translate off 
parity, data convert off, translate 

parity, data cfcnvert off, translate 


CLTAPE 00231 


of T^pe ££§ale4 by TAPS DUMP Cooma^d: 


CLTAPE n 0232 
CLTAPE 00233 
CLTAPE 00234 
CLTAPE 00235 
CLTAPE 00236 
CLTAPE 00236 
CLTAPE 00237 


Tape records written by TAPE DUMP are 805 tytes long. TLt 
first character is a binary 2 (X*02*), followed fcy the 
characters CHS and an EBCDIC blank (X*40*)» followed by 800 
bytes of file data packed without regard for logical record 
length. In the final record, the character K replaces the 
blank after CMS, and the data area contains directory 
information. 


CLTAPE 00239 


IA££0.D Restr ictions: 


CLTAPE 00240 
CLTAPE 00241 
CLTAPE 00242 
CLTAPE 00243 


The HEW and RUN functions indicate coopleticn before the 
physical operation is coapleted. Thus a subsequent 
operation to the sane physical device nay encounter a 
"device busy" situation. 


CLTAPE 

00245 

Responses 


CLTAPE 

00248 

DMSTPE7011 NULL FILE 


CLTAPE 

CLTAPE 

00250 

00251 

A final record was encountered and no prior records 
read in a TAPE LOAD operation. No file is created 

had been 
cn disk. 

CLTAPE 

:ltape 

00252 

00254 

If the JEgfl option is specified, the following is 
the teraiaal depending on the operation specified: 

typed to 

CLTAPE 

CLTAPE 

CLTAPE 

"0256 
00258 
00261 

LOADING..... 
fn ft fa 

• 
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CLTAPB 

CLTAPE 

CLTAPB 

CLTAPB 

CLTAPB 

CLTAPB 

CLTAPB 

CLTAPE 

CLTAPB 

CLTAPB 

CLTAPB 

CLTAPB 

CLTAPB 

CLTAPB 

CLTAPB 

CLTAPE 

CLT1PPDS 


00263 

00265 

00267 SKIPPING. 

00269 fa ft fa 

00271 DOBPIIG. 

00273 fa ft fa 

00275 

00277 

00279 

00281 SCANNING. 

00283 fa ft fa 

00285 

00287 

00289 

00290 Nhen a tape aark is encountered the following is typed to 
00292 the tarainal if the TBBN option is specified: 

00001 EVD-0F-FIL2 OB 2ND-0F-TAP2 
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CLTAPPDS 0000* IA££25 


CLTAPPDS 00006 The TAPPDS coma and is used to create CBS disic files froa 
CLTAPPDS 00007 tapes in unblocked card-iaage fornat. The tape «ay te 
CLTAPPDS 00008 unlabeled or contain OS standard labels. 


CLTAPPDS 00018 

i - 


[ft (fa]]] [(options...)] 

— i 

CLTAPPDS 00019 

| TAPPDS 

It fn 

1 


CLTAPPDS 00020 

1 

options; r i 


CLTAPPDS 00021 

1 


!£M 8 


CLTAPPDS 00022 

1 

1 

|NOPDS | 


CLTAPPDS 00023 

8 

8 

t J 

8 

CLTAPPDS 00024 

1 

8 

r i 


CLTAPPDS 00025 


8 

JCOL 1 | 


CLTAPPDS 00026 

i 

8 

*-NOCOL 1 J 


CLTAPPDS 00027 



r t 


CLTAPPDS 00*28 

8 

1 

JTAPn | 


CLTAPPDS 00029 



I1AE! 8 


CLTAPPDS 00030 

1 

1 

L i 


CLTAPPDS 00031 

8 

1 

r i 


CLTAPPDS 00032 

1 

1 

| END | 


CLTAPPDS 00033 

1 

1 

1 NOEND | 


CLTAPPDS 00034 


8 

i j 


CLTAPPDS 00035 

1 

8 

r i 


CLTAPPDS 00036 

8 

8 

INAXTEN | 


CLTAPPDS 00037 
CLTAPPDS 00038 

i . „■.. — 

8 

«-NOHAXXEN-* 

_ j 


CLTAPPDS 00045 fn 
CLTAPPDS 00046 
CLTAPPDS 00047 
CLTAPPDS 00047 
CLTAPPDS 00048 
CLTAPPDS 00048 
CLTAPPDS 00049 
CLTAPPDS 00049 
CLTAPPDS 00050 
CLTAPPDS 00051 
CLTAPPDS 00052 


specifies the filenaae of the disk file tc be 
created. This field has aeaning only if the 
NOPDS option is selected (that is, the tape 
does not contain aeabers cf a partitioned 
data set)• If the tape does contain aeabers 
of a partitioned data set (PIS), an asterisk 
aust be specified; one file is created for 
each nenber with filenaae the sane as the 
aeaber naae. If NOPDS is specified, the 
default filenaae is TAPPDS. Ihis is assuaed 
if the filenaae is onitted or ceded as ,, * w . 


CLTAPPDS 00055 ft 
CLTAPPDS 00056 
CLTAPPDS 00057 


specifies the filetype of the newly created 
files. The default filetype is CBSUI1, if ft 
is oaitted or specified as *. 


CLTAPPDS 00059 fa 
CLTAPPDS 00060 
CLTAPPDS 00060 
CLTAPPDS 00061 


specifies the disk on which to place the new 
files. The default filenode is II if this 
field is oaitted or specified as an 
asterisk(*) » 


218 







IBtl CONFIDENTIAL 


CLTAPPDS 


CLTAPPD3 

CLTAPPDS 

CLTAPPDS 

CLTAPPDS 

CLTAPPDS 

CLTAPPDS 

CLTAPPDS 


CLTAPPDS 

CLTAPPDS 

CLTAPPDS 


CLTAPPDS 

CLTAPPDS 

CLTAPPDS 

CLTAPPDS 

CLTAPPDS 

CLTAPPDS 

CLTAPPDS 

CLTAPPDS 

CLTAPPDS 

CLTAPPDS 

CLTAPPDS 

CLTAPPDS 

CLTAPPDS 

CLTAPPDS 

CLTAPPDS 

CLTAPPDS 

CLTAPPDS 

CLTAPPDS 

CLTAPPDS 

CLTAPPDS 

CLTAPPDS 


CLTAPPDS 


CLTAPPDS 

CLTAPPDS 


00065 



00066 

00067 

If conflicting 
is used. 

options are specified, the last one entered 

00069 

00070 

00070 

00^71 

00072 

m 

Indicates that the £ape contains members of 
an OS partitioned data set, each preceded by 
a "HEMBEH NAME=name H card. The tape must 
have been created by the os 1EEPTPCL utility 
if this option is specified. 

00076 

NOPDS 

Indicates that the tape contains ere file. 

00079 

00081 

COL1 

Indicates that column 1 contains data. Data 
is taken from columns 1-80 

00084 

00085 

00085 

00086 

fi2£2 U 

Indicates that column 1 ccntains control 
character information. Data is taken from 
columns 2-81. This is the format produced by 
the OS IEBPTPCH utility. 

00090 

00091 

00091 

00092 

00092 

00093 

TAPn 

Ihll 

n indicates the tape unit number. TAPI is 
the default tape unit number, Mhich 
corresponds to the virtual address 181. 
There are four possible values cf n: TAPI tc 
TAP4, indicating virtual tape drives 181 to 
184. 

00096 

00097 

00098 

END 

specifies that an END card bhen encountered 
means that the entire current member has been 
read. 

00101 

00102 

00103 

I«2£SJ2 

specifies that END cards are not to be 
treated as member delimiters, but are tc be 
processed as text. 

0 010 6 
00107 
00108 

NAXTEN 

Indicates that up to ten meibers are to be 
read. This is valid only if the PDS opticn 
is selected. 

00111 

00112 


Indicates that any number of members may be 
r ea d, 

00116 

Ies£orises 


0 9121 

DMSTPD703I FILE • fn ft [fa]» COPIED 

O'* 123 

The named file 

has been copied to disk 


CLTAPPDS 

CLTAPPDS 

CLTAPPDS 

CLTXTLIB 
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00125 DHSTPD707I TEN FILES COPIED 

00127 HASTEN has bean specified and ten seabecs hate been copied. 

00129 If the tape being read contains standard CS labels, the 
00001 labels are typed at the terninal. 
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CLTXTLIB 00003 


CLTXTLIB 00005 
CLTXTLIB 00006 
CLTXTLIB 00006 
CLTXTLIB 00007 


The TXTLIB comaand is used to perfoca aaictenance on CMS 
text libraries. A text library is one khich is to be 
searched for aissing subroutines in LOAD and INCLUDE 
coaaands. 


CLTXTLIB 00008 
CLTXTLIB 00009 
CLTXTLIB 00010 
CLTXTLIB 00011 


A text library is a file that has a filetype of TXTLIB and 
contains a dictionary and one or aore relocatable object 
prograas which were obtained froa CHS files having a 
filetype of TBXT. 


CLTXTLIB 00013 The TXTLIB coaaand performs the following functicns: 


CLTXTLIB 00016 
CLTXTLIB 00018 
CLTXTLIB 00020 


1. Generates a text library. 

2. Adds to an existing text library. 

3. Deletes froa an existing text library. 


CLTXTLIB 00023 
CLTXTLIB 00024 
CLTITLIB 00025 


4. Lists the naaes and aliases or entry points and control 
section naaes and the location of the TEXT files 
included in the text library. 


CLTXTLIB 

00036 

f— -.. - ■■ 

-- 




CLTXTLIB 

00037 

| TXTLIB 

1 ( 

(GEN ) 

libn fn ... 

) 

CLTITLIB 

00038 

i TXT 

t ( 

(ADD } 


} 

CLTXTLIB 

00039 

1 

i ( 



} 

CLTITLIB 

00040 

1 

s ( 

DEL 

libn aeaber ... 

i 

CLTXTLIB 

00041 


i ( 


r i 

} 

CLTXTLIB 

00042 


i ( 


| (TEBM) i 

} 

CLTXTLIB 

00043 

1 

i ( 

MAP 

libn | (PRINT) | 

i 

CLTITLIB 

00044 


! c 


1 <£!$£) 9 

) 

CLTXTLIB 

00045 

1 

i i 


L ^ J 

} 

CLTXTLIB 

00046 

t ... - ■ 






CLTXTLIB 00051 GBN 
CLTXTLIB 00052 
CLTXTLIB 00052 
CLTXTLIB 00053 
CLTXTLIB 00054 


a text library with a user-specified filenaae cf 
libn and a filetype of TXTLIB is to be created 
froa the TEXT files specified by fn 1 fn2... If 
a file exists with the identifier "libn TXTLIB", 
it is erased and a new one is created. 


CLTXTLIB 00057 ADD 
CLTXTLIB 00058 
CLTXTLIB 00058 
CLTXTLIB 00058 
CLTXTLIB 00059 
CLTXTLIB 00060 


the contents of the files specified by fnl 
fn2... are to be appended to the end c£ the 
existing library with the file identifier "libn 
TXTLIB". No checking for duplicate naaes, 
aliases, entry points or CSECT naaes is 
parf oraed. 


CLTXTLIB 00063 DEL 
CLTXTLIB 00064 
CLTXTLIB 00064 


the TEXT decks with aeaber naaes csectnl, 
csectn2... are to be reaoved free the directory 
of the file with the file identifier "libn 
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CLTXTLIB 00064 
CLTXTLIB 00065 
CLTXTLIB 00065 
CLTXTLIB 00067 


TXTLIB". If two aeibecs haws the sane naae as 
one specified by aeaber, only the first ere 
encountered is deleted (unless the aeaber naae 
is given twice in the argument list). 


CLTXTLIB 00068 
CLTXTLIB 00069 
CLTXTLIB 00069 
CLTXTLIB 00070 
CLTXTLIB 00070 
CLTXTLIB 00071 


Deletes aust be performed on the DARE or first 
Section Definition (SD) in the teat deck. A 
delete against an alias naae or subsequent entry 
point results in a "not found" aessage with nc 
change to the nenber. Delete removes the neuter 
and all references to it. 


CLTXTLIB 00072 
CLTXTLIB 00072 
CLTXTLIB 00073 


The file is autoaatically confessed so that 
space occupied by the deleted CSECTs may be 
reused. 


CLTXTLIB 00076 MAP 
CLTXTLIB 00077 
CLTXTLIB 00077 
CLTXTLIB 00078 
CLTXTLIB 00079 
CLTXTLIB 00079 
CLTXTLIB 00080 
CLTXTLIB 00C80 
CLTXTLIB 00081 
CLTXTLIB 00082 
CLTXTLIB 00"82 
CLTXTLIB 00083 
CLTXTLIB 00084 


the MAP fora of the TXTLIB command generates the 
file "libn MAP" on the user's primary disk. If 
a file already exists with the sane identifier, 
it is erased and the new file created. The 
"libn MAP" file contains the sane inferaatien as 
that in the dictionary of the specified text 
library and is in the fornat of a list of entry 
points and control section nanes that reside in 
the text library, and their location or index in 
the file. The option list on the ccmxand line 
is exaained to deteraine if the MAE is to re 
directed to the terminal (TERM) , cr the printer 
(PRINT) , or is to reaain on di.sk (DISK) . 


CLTXTLIB 00085 
CLTXTLIB 00086 
CLTXTLIB 00086 
CLTXTLIB 00087 


The MAP fora of TXTLIB types cut a statement 
indicating the total nuaber of entry pcints acd 
control section nanes that currently exist in 
the TXTLIB file. 


CLTXTLIB 00090 libn 
CLTXTLIB 00091 
CLTXTLIB 00092 


is the naae of the text 
added to, printed, or 
libn aust be TXTLIB. 


library to be generated, 
listed, The filetype cf 


CLTXTLIB 00095 £n 
CLTXTLIB 00096 
CLTXTLIB 00097 


specify the file(s) to be tsed in either 
generating or adding to a TXTLIB file. Their 
filetype aust be TEXT. 


CLTXTLIB 00098 
CLTXTLIB 00099 
CLTXTLIB 00099 
CLTXTLIB 00100 


Each TEXT file that is to be included in the 
TXTLIB file aust consist of one cr mere control 
sections with an END card image following each 
control section. 


CLTXTLIB 00104 aeaber 
CLTXTLIB 00105 
CLTXTLIB 00105 
CLTXTLIB 00106 
CLTXTLIB 00107 


specifies the naaes of the CSECTs to be deleted 
froa a TXTLIB file. Entries which are not 
control section definitions or naaes specified 
on a loader NAME control card result in a "not 
found” aessage and no change to the library. 
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CLTXTLIB 


CLTXTLIB 

CLTXTLIB 

CLTXTLIB 

CLTXTLIB 

CLTXTLIB 

CLTXTLIB 

CLTXTLIB 

CLTXTLIB 

CLTXTLIB 

CLTXTLIB 

CLTXTLIB 


CLTXTLIB 


CLTXTLIB 

CLTXTLIB 

CLTXTLIB 

CLTXTLIB 

CLTYPE 


00112 Nqte g 


00114 

00115 

00115 

00116 

00117 


The total nuaber ◦£ members the TXTI1B file cannct 
exceed 1000* When this nuaber is reached* an error 
message is typed out. The text library created 
includes all the text files entered cp tc (but not 
including) the one that caused the overflew. 


00120 

00121 

00122 

00122 

00123 

00124 


2. OS Linkage Editor ENTRY* ALIAS* and NAME ccntrol cards 
are accepted. If a NAME card is detected* ccly ALIAS 
and NAME 'naaes' will be included in the dictionary for 
that text deck. Deletes aust be performed cn the NAME 
•naae'. The total nuaber of ALIAS naaes cannot exceed 
sixteen naaes per text deck* 


00127 Resp o nses 


00129 xxx ENTRIES IN LIBRARY 

00130 When TXTLIB is issued* the contents of the dictionary of the 
00131 specified text library are typed out. The nuafcer ct entries 
00132 in the text library (xxx) is typed out when TXTLIE MAP is 
00001 issued. 
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CLTYPE 


CLTYP3 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 


00005 TYPE 


C0007 The TYPE command causes all or part of a sjecified file tc 
'■'0008 be typed at the terminal in either EBCDIC or the hexadecimal 
00009 representation of the EBCDIC code. 


00020 ,- ; -- 


0002 1 

1 


r r 11 




00022 

1 

TYPE | fn ft [fa] 

i (red) |recNj | 

[(options) ] 


C0023 



1 ( * H * II 




00024 

1 


L L JJ 

i— 



00025 

! 

1 

2£t iaass 

l inxj i y y y i I 


00026 


« 


f COL { 

} -1 } 1 


00027 

I 

1 


1 i J 

> LLX££l) i 


00028 

f 

1 


i_ 

— J 


00029 

1 

1 





00030 

1 

I 


»— —1 



00031 

1 

i 


1 HEX 1 



00032 

i 



<_ —» 



00033 

1 






00034 

1 



i— 

- 1 


00035 

1 



I 

{ * i 1 


00036 

1 

i 


| MEMBEd 

l } 1 


00037 

1 

i 


1 

(NAME } | 


00038 

1 

« 


» _ 

_j 



0 0039 «- ■> 


00 n 45 fn 
00046 


specifies the filename of the file tc tc typed. 
This field aust be speciried* 


00048 ft 

OOO49 


specifies the filetype of the file to te typed. 
This field aust be specified. 


00051 fa 

00052 

00053 

00054 

00055 


specifies the fileaode or the file tc te typed. 
If this field is oaitted, the A disk and its 
extensions are searched tc locate the file. In 
the case of files with duplicate filcnaae and 
filetype, only the first file found is typed. 


°0057 reel 
00058 
09059 
00^60 
00061 
00062 


specifies the record nuaber of the first record 
to be typed. This field aust certain nc special 
characters. If it is greater than the nuaber of 
records in the file, the file length is assumed. 
If this field is cnitted or entered as an 
asterisk, a record nuaber of 1 is assumed. 


0 0064 recN 

0 0064 

00065 

00066 

00067 


specifies the record nuaber of tnc last record 
to be typed. This value aust be less than 9999 
with no eabedded commas. If this field is net 
specified or is entered as an asterisk, typing 
continues until end of file is rcacned. 
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CLTYPB 

00071 

2E£i2fls 


CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

CLTYPE 

r '0074 

00074 

0 0075 
00075 
00076 
00077 
00078 
00078 
00080 

COL xxx-yyy 

specifies that only certain positions ot each 
record in the file are to fee typed. m 

specifies the beginning position and yyy the 
ending position (of the field within the record 
which is to be typed. If a field is not 
specified, the entire record is typed unless the 
filetype is LISTING, in which case the first 
position of each record is not typed, since it 
is assumed to be a carriage contxcl character. 

CLTYPE 

CLTYPE 

00083 

00C84 

HEX 

specifies that the file is tc te typed in 
hexadecimal format. 

CLTYPE 

CLTYPB 

CLTYPE 

CLTYPE 

00087 

00090 

00093 

00094 

HEHBEB 

none 

HEN 

if the file is a library, a HEHBEB entry may be 
specified. If * is entered, all individual 
members of the library are typed. If a name is 
specified, only that particular ternber is typed. 

CLTYPB 

00098 

Besponses 


CLTYPE 

CLUPDATE 

00099 

00001 

The file is typed at the terminal according to the given 
specifications. 
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CLOPDATB 


CLUPDATB 

CLUPDATB 

CLOPDATB 

CLOPDATB 

CLOPDATB 

CLOPDATB 

CLOPDATB 

CLOPDATE 

CLOPDATB 

CLOPDATB 

CLOPDATB 

CLOPDATB 

CLOPDATE 

CLOPDATB 


00009 


00006 The OPDATE coaaand provides a flexible and generalized 
00007 facility for aainteaance and aodification of progran source 
00008 files stored as 80-character card-iaage files with sequence 
00009 fields in record positions 73 to 80f OPDATE accepts a source 
00009 input file and one or aore files containing update control 
00010 cards and updated source records, and creates an updated 
00011 source output file, an update log file indicating wnat 
00011 changes, if any, were aade, and an update record file if 
00012 aore than a single update file was applied tc the input 
00013 file. 

00*14 Updates aay be applied either pecoanently (i.e. the updated 
00^15 output file replaces the source input file), cr teaporarily, 
00015 in which case the updated output file has the naae *jfn', 
00017 where *fn* is the file naae of the input source file. 
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CLUPDATE 

CLUPDATB 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 


CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 


00023 

00026 

00027 

00032 

00033 

00034 

00035 

00036 

00037 

00038 

00039 

D0040 

00041 

00042 

00043 

00044 

00045 

00046 

00047 

00048 

00049 

00D50 

00051 

00052 

00053 

00054 

00055 

00056 

00057 

00058 

00059 

00060 

00061 

00062 

00063 

00064 

00065 

00066 


i 

UPDATE t fnl [ f 11 [fnl [fn2 [ ft2 [£n2]]]]] [icpticns [)]], 


1 


options: 


1 HEPIAC£ | 

1 Ioeeelacj I 


S££8 

NOSEQ8 


INC 

NOJNS 


CTL 

NOCJi 


j ST F 
I NOS15 

i_ 


NOTEH8 


-■» 

I 

I 

_ j 


I DIM 

| PE1NT 


00077 £n1 ft 1 fnl 

00078 specifies the filename, filetype, and filenode 
00079 of the source input file. If the filenode or 
00079 filetype is omitted, *A1* and ’ASSEMBLE* ate 
00080 assumed, respecti7ely. 


000 84 
00085 
00086 
00086 
00087 
00087 
00088 
00088 


£n2 ft2 fa2 

specifies the filename, filetype, and filemcde 
of the file containing the update ccntrol cards 
and updated source records, or, if the 'CTL' 
option was specified, specifies the filename, 
filetype, and filenode of the update control 
file to be used for a multiple tpdate. The 
defaults are «fnl UPDATE A1« if NOCTL, and 'fnl 
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CLUPDATE 


CLUPDATE 


CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLOPDATB 


00089 


CNTHL A1' if CTL. 

00092 



00096 

00097 

REP 

specifies that the updated soucce file is tc 
replace the source input file. 

00100 

00101 

00102 

00103 

00104 

12M£ 

specifies that the old file is to be retained in 
its original fora, and the new file receives a 
different filename, consisting of a dollar sign 
(S) plus the first seven characters of the input 
filenaae (fnl). 

00106 
00107 , 
00109 

§m 

specifies that the entire sequence field 
(coluans 73 through 80) contains an eight-digit 
sequence nuaber on every record cf source input. 

00113 

00113 

00115 

NOSEQ8 

specifies that columns 73-75 contain a three 
character label field, and that the seguence 
nuaber is a five-digit value in coluans 76-80. 

00118 

00119 

00120 

00122 

INC 

specifies that the sequence nuaters in coluins 
73 to 80 of the updated records inserted froa 
the update file are to be included in the 
updated source file. 

00126 

00126 

00127 

00128 

£2I££ 

specifies that each updated record inserted froa 
the update file is to be identified by asterisks 
(•♦*******•) in coluans 73-80 in the updated 
source file. 

00132 

00133 

00133 

00135 

00137 

CTL 

specifies that fn2, ft2, fa2 describe an update 
control file for appiyiug multiple update files 
to the source input file, (see foraat 
description in a later section.) 

Not^e; The CTL option implies the INC option. 

00139 

00141 

&QQ2!t 

specifies that a single update file is tc be 
applied to the source input file. 

00146 

00146 

00147 

00149 

STK 

for use with ’CTL* option only, specifies that 
the results of the aultiple update are to be 
provided to an external EXEC procedure ty way cf 
the CHS console read stack. 

00153 

00154 

BQSIE 

specifies that no external coaaunication of the 
aultiple update results is desired. 

00157 

00158 

00158 

00158 

2EM 

specifies that warning aes&ages are to be typed 
on the terainal whenever a sequence cr update 
control card error is discovered. (Such warning 
messages will appear in the update log, whether 
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CLUPDATE 00160 


they are typed on the terminal oi not.) 


CLUPDATE 00163 
CLUPDATE 00163 
CLUPDATE 00164 
CLUPDATE 00165 


NOTES 19 


specifies that warning messages are not to be 
typed on the terainal. However, ericr nessage.s 
which abort the entire update procedure will be 
typed on the terainal anyway. 


CLUPDATE 00168 £I2£ 

CLUPDATE 00169 
CLUPDATE 00169 
CLUPDATE 00170 


specifies that the update log file is tc be 
placed on dish. This file will have fileid 
"fnane 090100“, where H fname M is the filename of 
the file being updated. 


CLUPDATE 00173 PRINT 
CLUPDATE 00174 


specifies that the update log file is to be 
printed directly on the virtual printer. 


CLUPDATE 00177 


Control Carls 


CLUPDATE 00179 
CLUPDATE 00180 
CLUPDATE 00181 
CLUPDATE 00181 
CLUPDATE 00182 
CLUPDATE 00183 
CLUPDATE 00184 
CLUPDATE 00184 
CLUPDATE 00185 
CLUPDATE 00186 
CLUPDATE 00186 
CLUPDATE 00187 
CLUPDATE 00188 


The UPDATE control cards allow specification of insertions, 
deletions, and replacement of source records, as well as 
reseguencing of the output file. All UPDATE ccntrol cards 
are identified by the characters ' ./* in columns 1 and 2 cf 
the 80-byte record, followed by one or more blanks and a 
maximum of six additional, blank-delimited fields. Control 
card data nay not extend beyond column 50. All references to 
the sequence field of an input record refer tc the numeric 
data in columns 73-80 of the source record, cr columns 76-8C 
if NOSEQ8 was specified. Leading zeroes in sequence fields 
are not required. If no sequence numbers exist cn an input 
file, a preliminary UPDATE with only the •./ S' ccntrol card 
can be used to establish file sequencing. 


CLUPDATE D0189 
CLUPDATE 00190 
CLUPDATE 00190 
CLUPDATE 00191 
CLUPDATE 00192 
CLUPDATE 00192 
CLUPDATE 00194 


Any sequence fields on the update control cards are ignored; 
if the NOINC option is used, all sequence fields in the 
update file are ignored, including those cc inserted 
records. If the INC option is used, sequence fields for the 
inserted records are either generated by UFDA1E (if the 
dollar-sign delimiter is used) or are included intact 
from the update file (if the dollar-sign '$' is net used). 


CLUPDATE 00195 
CLUPDATE 00196 
CLUPDATE 00196 
CLUPDATE 00197 
CLUPDATE 00198 
CLUPDATE 00199 
CLUPDATE 00200 
CLUPDATE 00200 
CLUPDATE 00201 
CLUPDATE 00202 
CLUPDATE 00202 
CLUPDATE 00203 


Changes are made sequentially in a single pass through the 
input and update files; an error condition results if any 
sequence errors occur in the update conticl cards, and 
warnings are issued if an error is detected in the 
sequencing of the input file. Any source input records with 
a seq uence field of J9l£JJk§ will be skipped over by the 
UPDATE command, without any indication of a sequence error. 
Such records may be replaced or deleted only if they occur 
within a range of records, the limits of which are sequenced 
normally, which is being replaced or deleted in toto; there 
is no means provided for specifying a sequence target cf 
blanks on an update control card. 
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CLUPDATE 


CLOPDATE 

CLUPDATE 

CLOPDATE 

CLUPDATE 

CLUPDATE 

CLOPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLOPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLOPDATE 

CLUPDATE 

CLOPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 


CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 


00205 Saatlfli Card F pcaa ts 


00207 1. Resequence the updated source output file. 


00214 

00217 

00218 


i —- -1 

| ./ S [seqstrt [seqincr [label]]] | 


00227 S 
00228 
00228 
00229 
00229 
00230 


specifies that the updated outpct file is tc be 
sequenced in coluans 73-80 (if S BC8 is 
specified), or in coluans 76-80 kith the 'label' 
placed in coluans 73-75 (if NOEEC6 is 
specified). If this card is included in the 
update file, it Bust be the first ccnttcl card. 


00233 seqstrt 

00234 

00235 


a one- to eight-digit nuaeric field specifying 
the first deciaal sequence nuater to be used. 
Defaults to 1000 for SEU8, 10 f6i NQSEC8. 


00238 seqincr 

00239 

00240 


a one- to eight-digit nuaeric field sjecifyirg 
the deciaal increaent for resequencing the 
output file. Defaults to 'segstrt' value. 


00243 

label 

00244 


00244 


00245 



a three-character field to be duplicated in 
coluans 73-75 of each source record if hOSECS is 
specified. Defaults to the first three 
characters of the input filenaae (fnl). 


00247 An error will be indicated if any valid ccntrcl card 
00248 precedes the './ S* card in the update file, and the 
00249 resequence operation will be suppressed. 


00250 Each source record is resequenced in ccluans 73-60 as it is 
00251 written to the output file. Both unchanged records froa the 
00251 input file and records inserted froa the update file are 
00252 resequenced. 


00255 2. Insert update records into the output file. 


00262 

00265 

00266 


I-T 

I ./ I segno [$ [seqstrt [seqincr]]] I 

«-;_j 


00275 I 

00276 

00277 


specifies that all cards folloking the './ i» 
card, up to the next control card, are to be 
inserted in the output file. 


00280 segno 
00281 


the sequence field of the source input record 
following which the insertion is to be Bade. 
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CLUPDATE 00285 t 
CLUPDATE 00285 
CLUPDATE 00286 


optional delimiter key indicating 
inserted records are to be 
incrementally. 


that the 
sequenced 


CLUPDATE 00289 seqstrt 
CLUPDATE 00290 
CLUPDATE 00291 


a one- to eight-digit numeric field specifying 
the first decimal number to be used £cr 
sequencing the inserted records. 


CLUPDATE 00294 seqincr 
CLUPDATE 00295 
CLUPDATE 00296 


a one- to eight-digit numeric field specifying 
the decimal increment for sequencing the 
inserted records. 


CLUPDATE C0298 
CLUPDATE 00299 
CLUPDATE 00300 
CLUPDATE 00300 
CLUPDATE 00302 
CLUPDATE 00302 
CLUPDATE 00303 
CLUPDATE 00303 
CLUPDATE 00304 


All records following the './ I* card, up to the next 
control card, are inserted in the output file following the 
record identified by the ‘segno* field. If the NOINC option 
was specified, each inserted record is identified with 
asterisks {•***♦****») in columns 73-80. If either the INC 
or CTL option was specified, the records are inserted 
unchanged in the output file, or they are sequenced 
according to the 'seqstrt* and ‘seqincr* fields if the 
dollar sign key was included. 


CLUPDATE 00305 
CLUPDATE 00306 
CLUPDATE 00307 
CLUPDATE 00307 
CLUPDATE 00309 
CLUPDATE 00310 
CLUPDATE 00311 
CLUPDATE 00313 
CLUPDATE 00314 
CLUPDATE O0315 
CLUPDATE 00316 
CLUPDATE 00317 


The default sequence increment, if the dollar sign is 
included, is determined by using one tenth of the least 
significant, non-zero digit in the 'segno' field, with a 
maximum of 100. The default 'seqstrt* is computed as 'segno* 
plus the default 'seqincr'. For example, the card: 

./ I 2600 $ 26 10 

would cause the inserted records to be sequenced XXX02610, 
XXX02620, etc. (N0SEQ8 assumed here). For the card: 

./ I 240000 $ 

the defaulted 'seqincr* would be the maximum, 100, and the 
starting sequence would be 240100. 5EQ6 was assuaed, so the 
inserted records would be sequenced 00240100, 00240200, etc. 


CLUPDATE 00318 
CLUPDATE 00319 
CLUPDATE 00319 
CLUPDATE 00320 


If either INC or CTL was specified but the dollar sign was 
not included, whatever sequence appears cn the inserted 
records in the update file will be included in the output 
file. 


CLUPDATE 00322 


3. Delete one or more records from the source file. 


CLUPDATE 00329 
CLUPDATE 00332 
CLUPDATE 00333 

CLUPDATE 00342 
CLUPDATE 00343 

CLUPDATE C0346 
CLUPDATE 00347 


I ./ D segno 1 [seqno2 J £$] | 

i---1 

seqnol specifies the sequence field identifying the 

first or only record to be deleted, 

seqno2 specifies the sequence field of the last record 

to be deleted. 


231 


IBM CONFIDENTIAL 


CLOPDATE 

CL0PDATE 

CLOPDATE 

CLOPDATS 

CLOPDATE 

CLOPDATE 


CLOPDATE 

CLUPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 


CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 


00350 $ optional deliaiter indicating the end of the 
00351 control fields. 

00353 All records of the input file, beginning at 'seqnol', are 
00354 • deleted froa the output file, up to and including the 
00354 'segno2' record. If the 'seqno2' field is caitted, only a 
00356 single record is deleted. 


00357 4. Beplace one or aore input records with updated records 

00358 froa the update file. 


00365 

00368 

00369 


---, 

8 segno 1 [segno2] [$ [segstrt [segincr]]]j 



00378 

00379 

segno 1 

specifies the sequence nuaber of the first input 
record to be replaced. 

00382 

00383 

segno2 

specifies the sequence nuaber of the last record 
to be replaced. 

00386 

00386 

00387 

$ 

optional deliaiter key indicating that the 
substituted records are to be sequenced 

increaentally. 

00390 

00391 

00392 

segstrt 

a one- to eight-digit nuaeric field specifying 
the first deciaal nuaber to be used for 
sequencing the substituted records. 

00395 

00396 

00397 

segincr 

a one- to eight-digit nuaeric field specifying 
the deciaal increnent for sequencing the 
substituted records. 

00399 

00400 

00400 

00401 

00401 

00402 

00402 

00403 

00403 

00404 

00404 

00405 

All records of the input file, beginning with the 'seqncl' 
record, up to and including the *segno2' record, are 
replaced in the output file by the records f(Hewing the *./ 
H» card in the update file, up to the next control card. As 
with the './ D' function, if the f seqno2* field is caitted, 
only a single record is replaced, but it nay be replaced by 
aore than a single inserted record. The *./ F* (replace) 
function is perforaed as a delete followed by an insert, 
such that the nuaber of cards substituted need net natch the 
nuaber replaced. The dollar sign • $•, 'segstrt', and 
'seqincr' processing is identical to that for the insert 
function. 

00407 

00414 

00417 

00418 

5. Consent 

cards 

1 

»_ 

» 

./ * [consent] 1 

... ——— —. — — -j 
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CLUPDATE 

CLUPDATE 

CLOPDATE 


CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 


CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 


CLUPDATE 

CLUPDATE 


00427 * 

00428 

00429 


specifies that this is a content card, and is to 
be ignored, except that it is copied into the 
log file. 


00434 S m im ary of Input aasi O ut put File s £o Command 


00436 1. Input files when a single update is to be applied. 


00437 When the "CTL* option is not specified in the UPDATE command 
00438 line, then only one update is applied to the scurce file, in 
00438 accordance with the methods described in the preceding two 
00440 sections. There are two input files: 


0C444 

00444 

00445 

00445 

00447 


a. The source file, which is to be updated. The 
filename of this file must be specified in the 
command line. The filetype and filemode will 
default to ASSEMBLE and Al, respectively, unless 
overridden by the command line. 


00451 

00452 

00452 

00453 

00453 

00454 


b. The update file, whose control cards have been 
described in the preceding section. The filename cf 
this file will default to the filename ot the source 
file, and the filetype and filemode will default to 
UPDATE and AT, respectively. All three may te 
overridden by the command line. 


00457 2. Output files when a single update is applied. 

00456 Whan a single update is applied to the scurce file, the 
00459 following output files are created: 


00462 

00463 

00463 

00463 

00464 

*0465 

00466 


a. An updated source file is created. The filename cf 
this file will be '’ifn", where "fn" is the filename 
of the original source file, unless the REP option 
was specified. In the latter case, the filename of 
this file will be ”fn M . (For modifications of these 
rules when an error occurs, see the section below cn 
update error handling.) 


00468 

00468 

*0469 

00469 

0D470 

00471 

00471 

*0472 


b. An update log, showing all transactions and errors, 
will be created. The filename of tie file will be 
M fn", where "fn" is the filename cf the original 
source file, and the filetype of this file will be 
UPDLOG• Note, however, that if the PRINT option is 
specified with the command line, thee the update leg 
will be printed directly on the virtual spooled 
printer, and no disk file will be created.' 


00475 3. Input files when multilevel updates are applied. 

*0476 When the CTL option is specified on the command line, then 


233 


IBM CONFIDENTIAL 


CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 


CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 


00477 aulti-level updates are applied to the source file. Io this 
00477 case, the following files are inputted to the UPDATE 
00478 coaaand: 


00481 

00482 


a. A source file, specified in exactly the sane 
way as the source file for a single update. 


00486 

00486 

00487 

00487 

00488 

00488 

00489 

00489 

00489 

00490 

00491 


b. A control file, which controls what updates are 
applied, and the order in which they are to be 
applied. The filenaae of this file will 
default to the file naae of the source file, 
and the filetype and fileaode will default tc 
CNTBL and A1, respectively. All three may be 
overridden by the coaaand line. This file will 
contain, in its control cards, pointers tc 
update files, PTM files, 'and ‘AUX* auxiliary 
files, which are listed in the fcllcw^ng 
sections. 


00495 

00495 

00496 

*0496 

00497 

00498 


c. One or nore update files, as specified by the 
control file. The filenaae of these files will 
be the sane as the filenaae of the source file. 
The filetype of these files will "UFDTxxxx", 
where the "xxxx" portion is specifed by the 
control file. 


00502 

00503 

00503 

00504 

00504 

00504 

00505 

00505 

00506 


d. ® AUX* auxiliary files, as specified by the 
control file. The filenaae of these files will 
be the sane as the filenaae of the source file. 
The filetype of these files will be "AUXxxxx", 
where the "xxxx" portion is specified by the 
control file. The AUX files contain additional 
control cards pointing tc PTM files. The 
fornat of the AUX files is described in a later 
section. 


00510 

00510 

00511 

00511 

00512 

00512 

00513 

00513 

00514 


e. PTM files, as specified by either the control 
file or the AUX files. The filenaae of these 
files is the saae as the filenaae of the source 
file. The filetype will be specified in full 
by the control file or the AUX file. In 
fornat, these files are identical tc ordinary 
update files. They are given the special naae 
"PTM files," in order to confers to IBM AFAR 
processing procedures. 


00517 4. Output files when aulti-level updates arc applied. 

00518 When the CTL option is specified, then the fcllcwing output 
00520 files are created by the UPDATE coaaand: 

00523 a. An updated source file, as in the case of a single 

00524 update. 
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CLOPDATE 00528 b. An update log, as in the case of a single update. 


CLUPDATE 00531 
CLUPDATB 00532 
CLDPDATE 00532 
CLOPDATE 00533 
CLUPDATE 00533 
CLDPDATE 00534 


c. An UPDATES file. This file will have the filename ci 
the original source file, and a filetype cf UPDATES. It 
contains summary information about which updates were 
applied to the file, and is intended to be ccncatenated 
onto the assembly text dec* for documentation and 
information purposes. 


CLDPDATE 00537 
CLOPDATE 00538 
CLDPDATE 00538 
CLUPDATB 00539 
CLUPDATE 00540 


d. Although not a disk file, additional "cut put” is 
produced in the form of lines placed in the terminal read 
stack, for interrogation by an EXEC file which may have 
invoked the UPDATE command. These lines are placed there 
only if the STK option is specified. 


CLUPDATE 00543 


5. Disk mode of output files 


CLUPDATE 00544 
CLUPDATE 00545 
CLDPDATE 00546 
CLUPDATE <>0546 
CLDPDATE 00548 


If there are several read/write disks accessed when the 
UPDATE command is invoked, then the the following steps are 
taken to determine the disk upon which the cutptt files are 
to be placed (the search stops as soon as cne of the 
following steps is successful): 


CLUPDATE 00552 
CLDPDATE 00553 
CLUPDATE 00554 


a. If the disk on which the original source file lies 
is read/write, then the output files are placed cn 
that disk. 


CLUPDATE 00557 
CLUPDATE 00558 
CLUPDATE 00559 


b. Otherwise, if that disk is a read/only extension of a 
read/write disk, then the output files are placed cn that 
particular read/weite disk. 


CLUPDATE 00562 c. Otherwise, the output files are place on the primary 
CLUPDATE 00563 read/write disk (the A-disk). 


CLOPDATE 00566 


The ' Cli* Option 


CLUPDATE 00567 
CLUPDATE 00568 
CLUPDATE 00568 
CLUPDATE 00569 
CLUPDATE 00569 
CLUPDATE 00570 
CLDPDATE 00571 
CLDPDATE 00571 
CLOPDATE 00572 
CLDPDATE 00572 
CLDPDATE 00573 
CLUPDATE 00574 
CLUPOATE 00574 
CLDPDATE 00575 


If the NOCTL option is specified or defaulted, UPDATE will 
process one input file and one update file tc produce an 
updated source output file and an update log file containing 
a record of what changes were made. This mede cf eperatien 
is suitable for testing fixes and modifications prior to 
incorporating them in the base source code, providing that 
only one set of changes has to be tested at a time. If, for 
any reason, more than one set of changes is outstanding 
against a single source input file, the difficulties in 
managing that base code can multiply very rapdily. For this 
reason, UPDATE provides the CTL option, which embodies a 
multiple-update control and management scheie developed fet 
use in maintaining VB/370 distributed source code, and nay 
be used wherever its advantages are felt. 
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CLOPDATE 00576 
CLUPDATE 00577 


The major components of the multi-level update scheme are as 
follows: 


CLUPDATE 00580 
CLUPDATE 00581 
CLUPDATE 00583 
CLUPDATE 00584 
CLUPDATE 00586 
CLUPDATE 00586 
CLUPDATE 00587 
CLUPDATE 00589 
CLUPDATE 00590 


1. A set of base source code which is not permanently 
changed. 

2. A set of update files for each soiree file which 
must be applied in a specific order. 

3. One or more 'CNTBL' files which describe the order 
or priority of updates to be applied to each source 
file. 

4 . Optionally, one or more auxiliary ('AUX') control 
files, each specific to a certain source file. 


CLUPDATE 00594 
CLUPDATE 0594 
CLUPDATE 00595 
CLUPDATE 00596 
CLUPDATE 00597 
CLUPDATE 00597 
CLUPDATE 00598 
CLUPDATE 00598 
CLUPDATE 00599 
CLUPDATE 00600 
CLUPDATE 00601 
CLUPDATE 00602 
CLUPDATE 00602 
CLUPDATE 00603 
CLUPDATE 00603 
CLUPDATE 00605 
CLOPDATE 00605 
CLUPDATE 00606 
CLUPDATE 00606 
CLUPDATE 00607 
CLUPDATE 00608 
CLUPDATE 00608 
CLUPDATE 00609 
CLUPDATE 00609 
CLUPDATE 00610 
CLUPDATE 00611 
CLUPDATE 00612 


An integral part of the multi-level update scheme is a 
naming convention for the update files themselves, and fer 
any TEXT files produced by assembling or compiling the 
updated output files. In normal usage, any update file will 
have the filename of the source file to which it applies and 
the filetype of 'UPDATE'. When the CTL option is used to 
invoke the multi-level update controls, the filename usage 
becomes a requirement, such that the update files must have 
the filename of the source file to which they apply, tut the 
filetypes are modified to distinguish between separate 
update levels. The filetype for an update file is 
constructed from 'UPDT' plus a one- to four-character upd ate 
identifier . For example, for a source file of 'DMSUPD 
ASSEMBLE', there might be three update files, named •DMSUPD 
UPDT750', 'DMSUPD UPDTX4', and 'DMSUPD UPDT009*. In this 
example, the update identifiers are '750', 'X4', and '009*. 
The 'CNTBL' file, mentioned in (3) above, specifies which 
update files are to be applied to the source file and in 
what order they are to be applied, on the basis cf the 
update identifier . Another identification parameter, the 
upda te leve l identifier , is used when naming a TEXT tile 
produced from the updated source file. The update level 
identifier is specified by the 'CNTBL' file and is 
associated with a specific update identifier, also in the 
•CNTRL' file. For example, a file named 'X4 CNTBl•, tc apply 
the above mentioned updates to 'DMSUPD ASSEMEIE*, might lock 
like the following: 


CLUPDATE 00615 
CLUPDATE 00616 
CLUPDATE 00617 
CLUPDATE 00618 


00D MACS DMSLIB SYSLIB 
X4D X 4 
75X 750 

009X 009 


CLUPDATE 00621 
CLUPDATE 00622 
CLUPDATE 00623 
CLUPDATE 00623 
CLUPDATE 00624 
CLUPDATE 00625 
CLUPDATE 00625 
CLUPDATE 00626 


This control file would apply the updates 'DMSUPD UPDT009', 
•DMSUPD UPDT750', and 'DMSUPD UPDTX4•, in that order, to the 
file 'DMSUPD ASSEMBLE'. The updates are applied in reverse 
order as they appear in the 'CNTBL* file, that is, the 
'lbwest-level* of update is at the bottom of the file, and 
the 'highest-level* update is at the top. As the CNTBL file 
and update files are processed, UPDATE will type at the 
terminal the message: 
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CLOPDATE 

CLUPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLUPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLOPDATE 

CLUPDATE 

CLOPDATB 

CLOPDATE 

CLOPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 

CLUPDATE 


CLUPDATE 

CLUPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATE 

CLOPDATB 


00629 DMSOPD17 81 UPDATING Cfn ft fa*> WITH 'fn ft fa* 

00631 for each update file which is applied to the source input 
00632 during the aulti-level update, where the bracketed 
00633 expression will be typed only for the first update. 

00634 In the above exaaple, the fields* '14D* , *75X*, and '009X* 
00636 are the update lave! i^SnlifAgls, associated with the »X4', 
00637 *750', and *009* update identifiers, respectively. According 
00637 to the naaing convention for VM/370 TEXT files, the 
00638 resultant of asseabling the updated »$DMSUPL ASSEHELE* file 
00638 would be naaed 'DMSUPD TXTX4D', where the *X4D» is the 
00640 update level identifier of the highest -lev el update applied. 
00640 The 'TXT' portion of the filetypa indicates that this is a 
00641 TEXT file, but allows up to a five-character update level 
0 0642 identifier. 

00644 CUTSL File Forpat 

00645 The CMTBL files used by the aulti-level update scheme must 
00646 be 80-byte, card-iaage files. There are six different 
00647 control record formats recognized by UPDATE, as fellows: 


00651 

00652 

00654 

00655 

00657 

00658 

00660 

00661 

00663 

00664 

00665 

00667 

00668 

00669 


1. The 'MACS' record, normally the first line in the 
CMTBL file. 

2. Comment cards, containing an asterisk (*) in ccluan 
1, which are ignored. 

3. Update level control records, containing both an 
update level identifier and an update identifier. 

4. TEXT-file control records, containing only an update 
level identifier, which are ignored by UPDATE. 

5. Auxiliary file control records, containing an update 
level identifier, an update identifier, and the 
keyword 'A0X', 

6. Single PTF control records, containing the keyword 
'PTF' in place of the upxiate level identifier, and 
up to an eight-character update identifier. 


00672 All fields on CNTBL and A0X file records are free-fornat, 
00673 blank-delimited fields which aay not extend fceyend record 
00673 position 72. Any sequence fields on CNTEL or AUX file 
00674 records are ignored. The foraats and uses of each record 
00675 format, by number, are as follows: 


00678 1. The 'MACS* record - must precede any other records 

00679 except coaaents. 

00681 uplevel MACS libraryl library^ ... 


00682 

00683 

00683 


This record defines the defaul t update level 
identifier, i.e, the update level identifier which is 
associated with the application of pp updates at all. 
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CL0PDATE 00684 
CLUPDATE 00684 
CLUPDATE 00685 
CLUPDATE 00686 


CLUPDATE 00689 
CLUPDATE 00690 

CLUPDATE 00692 

CLUPDATE 00694 


CLUPDATE 00697 
CLUPDATE 00698 

CLUPDATE 00700 

CLUPDATE 00701 
CLUPDATE 00702 
CLUPDATE 00702 
CLUPDATE 00704 
CLUPDATE 00704 
CLUPDATE 00705 
CLUPDATE 00705 
CLUPDATe 00706 
CLUPDATE 00706 
CLUPDATE 00707 


CLUPDATE 00710 
CLUPDATE 00711 

CLUPDATE 00713 

CLUPDATE 00714 
CLUPDATE 00715 
CLUPDATE 00715 
CLUPDATE 00716 
CLUPDATE 00717 


CLUPDATE 00720 
CLUPDATE 00721 

CLUPDATE 00723 

CLUPDATE 00724 
CLUPDATE 00725 
CLUPDATE 00725 
CLUPDATE 00726 
CLUPDATE 00726 
CLUPDATE 00727 


aad it defines the list of nacro libraries which should 
be used when assembling or compiling the updated source 
files. The keyword * MACS * identifies this recced 
foraat. 


2. Consents - aay occur anywhere within either the CNTfil 
file or any AUZ files. 

* consents... 

The asterisk aust appear in record position cne. 


3.. Update level control records - specifies an update to 
be applied. 

uplevel upid 

The update file naaed 'fnane UPDTupid', if it exists, 
is to be applied to the source input file, and the 
level identifier 'uplevel* is to be associated with the 
application of that update file. The ' u{level* field is 
a aazinua of five characters, and the 'upid* field is a 
naxiaua of four characters. If the specified 'UPDTupid' 
file is not found by UPDATE.* no error occurrs and the 
next higher update level control record is processed, 
until the top of the CNTBL file is reached or the 
'MACS' record is encountered. 


4. TEXT-file control records - ignored by the UPDATE 
coanand. 

uplevel 

This record foraat is intended for use by the VM/373. 
service progran VMPLOAD. which will produce a systea 
load deck froa multiple 'TXTuplevel' files. The UPDATE 
coanand ignores any TEXT-file control records since 
they do not specify an update identifier. 


5. Auxiliary file control records - specifies 'fnane 
AUXupid* files. 

uplevel upid AUX 

The keyword 'AUX*. following the update identifier, 
indicates that this single update level nay. in itself, 
consist of multiple update file'b. specified in list 
fora in the file 'fnane AUXupid'. This feature is used 
where a set of update files are inter-dependent (e.g. 
related PTP's). The auxiliary file aay contain coaaent 
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CLUPDATE 00728 
CLUPDATE 00729 


records and/or update specification records, as 
follows: 


CLUPDATE 00731 
CLUPDATE 00732 
CLUPDATE 00733 
CLUPDATE 00734 


* PTF A34216CA FIXES MNOP BUG IN EKFCCrf 

A34216CA 

PTF A09156CA REPAIR TRANSLATE IAELE 

* 


CLUPDATE 00735 
CLUPDATE 00736 
CLUPDATE 00736 
CLUPDATE 00737 
CLUPDATE 00737 
CLUPDATE 00738 
CLUPDATE 00738 
CLUPDATE 00739 
CLUPDATE 00739 
CLUPDATE 00740 
CLUPDATE 00740 
CLUPDATE 00741 
CLUPDATE 00741 
CLUPDATE 00742 
CLUPDATE 00743 


As noted in the above example, the auxiliary file 
mechanism is used for applying PTF*s, in this case the 
files •fname A09156CA*, and 'foame A34216CA* would be 
applied to the input file as updates, in that cider. 
The aajor difference in processing when the 'AUX' 
option is used, is that all updates specified in the 
auxiliary file oust be present, or an error is 
indicated, and that the full eight-character filetype 
is specified instead of the 'UPDTxxxx' modifier. The 
filetypes shown above are in IBM standard AFAR-answer 
format, consisting of 'A....6CA*, with the A PA B number 
in the middle. The updates specified ir the auxiliary 
file are also applied in reverse order, from the lowest 
to the highest level, as they are in the renal CNTflL 
file. 


CLUPDATE 00746 6. Single PTF control records - specifies a PTF to be 

CLUPDATE 00747 applied. 

CLUPDATE 00749 PTF filetype 


CLUPDATE 00750 
CLUPDATE 00751 
CLUPDATE 00751 
CLUPDATE 00752 
CLUPDATE 00754 
CLUPDATE 00754 
CLUPDATE 00755 
CLUPDATE 00755 
CLUPDATE 00756 
CLUPDATE 00756 
CLUPDATE 00757 
CLUPDATE 00757 
CLUPDATE 00759 


The keyword 'PTF* in the update level identifier field 
indicates that a full filetype was specified in the 
*upid' field instead of a four-character update 
identifier, and that this update file has no u pd ate 
level identifie r associated with its application. Since 
the update level identifier will not indicate whether 
or not the PTF was applied, this form is not 
recommended for applying PTF's which are specific tc 
certain source files. The purpose of this format is to 
provide a means of applying a 'global' PTF to many 
source files, without reguiring a separate 'AUXupid* 
file for each source file affected. Nc error is 
indicated if the PTF specified is not feund. 


CLUPDATE 00762 Each CNTBL file to be used by the UPDATE ccmmand must 
CLUPDATE 00763 contain a single 'MACS' record as the first ncn-conment 
CLUPDATE 00763 record, but thereafter may contain any cf the records 
CLUPDATE 00764 specified in any order, 

CLUPDATE 00766 Ifca S TK/NOSI K £e£A2HS 
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CLUPDATB 00767 
CLUPDATB 00768 
CLUPDATE 00769 
CLOPDATE 00769 
CLUPDATE 00770 
CLUPDATB 00771 


The STK option is provided for use with the *ulti-iev«l 
update invoked via the CTL option, primarily for 
coasunication with CHS EXEC procedures which invckc UPDATE, 
If the CTL and STK options are specified, UEDATE will place 
tvo lines of data in the CHS terainal read stack, as 
follows: 


CLUPDATB 0077H 
CLUPDATE 00776 


first line * * yp da te level ide ntifi er 

second line * * library list froi •HAC£* record 


CLUPDATE 00778 
CLUPDATE 00779 
CLUPDATB 00779 
CLUPDATE 00780 
CLUPDATE 00781 
CLUPDATE 00781 
CLUPDATE 00782 
CLUPDATE 00782 
CLUPDATB 00783 
CLUPDATE 00784 
CLUPDATE 00785 


These lines are placed in the terainal read stack via the 
CHS •ATTN * function, and are available to an invoking EXEC 
procedure via the EXEC control words '&BEAD AEGS* cr 'GBEAD 
TABS*. The first line, the update level identifier, is the 
level identifier of the highest-level update applied; this 
is the TEXT-file filetype aodifier used by the VH/37C 
aaintenance procedures. The second line consists cf the list 
of libraries specified on the 'HACS' record in the CN1BL 
file. The library search order for an asseably or 
coapilation can be established by issuing the *GLOBAL' 
coaaand using the library list returned. 


CLUPDATE 00786 If the NOSTK option is used with the aulti-level update, no 

CLUPDATE 00787 data is aade available to external procedures. 


CLUPDATE 00709 Wa r ning and Er ror Handling 


CLUPDATB 00790 
CLUPDATB 00791 
CLUPDATB 00791 
CLUPDATE 00792 
CLUPDATE 00793 


The UPDATE coaaand detects a nuaber of invalid reguests, and 
decides whether they should be treated as warning situations 
or as errors. The following is a general description cf 
the handling of these situations,, and the return codes 
associated with each: 


CLUPDATE 00795 1. Sequencing and Update Control Card Errors 


CLUPDATB 00796 
CLUPDATB 00797 
CLUPDATB 00797 
CLUPDATB 00798 
CLUPDATE 00799 


These errors are treated as "warning situations." That is, 
a warning aessage is generated, and processing continues. 
The warning aessages will be printed in the update leg, and 
will be typed on the terainal unless the NCTEBH option is 
specified in the coaaand line. 


CLUPDATE 00803 
CLUPDATE 00804 
CLUPDATE 00804 
CLUPDATE 00805 


a. Input sequencing errors (return code = 4). These 

errors are detected when the input source file 
contains seguence errors (sequence nuabers in 
non-ascending order)• 


CLUPDATE 00808 
CLUPDATE 00809 
CLUPDATE 00809 
CLUPDATE 00810 


b. Output sequencing errors (return code * 8). These 
errors are detected when the updating procedure 
introduces new sequencing errors into the cut put seuxee 
file. 
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CLUPDATE 00813 
CLUPDATE 00814 
CLUPDATE 00814 
CLUPDATE 00816 


c. Invalid update control cards (return cede = 12). These 
errors are detected when the update file contains invalid 
control cards. (As described below, erreneous cards in 
control files cause the update procedure to abort.) 


CLUPDATE 00818 If nore than one such error is detected, the update will 

CLUPDATE 00820 return the aaxiaua return code (4, 8 or 12) encountered. 


CLUPDATE 00821 
CLUPDATE 00822 
CLUPDATE 00822 
CLUPDATE 00823 


If any such error is detected, then the BEP option, if 
specified, will be ignored, and the output source file will 
reaain with the filename N $fn", as if NOIEPLACE were in 
effect. 


CLUPDATE 00825 


2. Other errors. 


CLUPDATE 00826 
CLUPDATE 00827 
CLUPDATE 00827 
CLUPDATE 00829 


These errors include such things as invalid ccntrol file 
cards, invalid file formats, and disk i/c errors. The 
UPDATE connand processing is aborted as soon as the errer is 
detected. The return code will always be 20 or greater. 


CLUPDATE 00830 
CLUPDATE 00831 
CLUPDATE 00831 
CLUPDATE 00832 
CLIHCOB 00001 


If any such error is detected, then the output file will be 
left with the filename UPDATE and the filetype CESUT1, sc 
that the user aay, if he wishes, exaame or otherwise make 
use of it. This file aust be erased before the UPDATE 
coaaand can be invoked again. 
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CLIHCOH 


CLIHCOM 
CLIMCOM 
CLIHCOM 
CLIMCOM 
CLIMCOM 
CLIMCOM 
CLIHCOM 
CL HO 


0000* IM MEDIATE CO MM ANDS 


00007 An IMMEDIATE Coaaand is issued after an Attention interrupt 
00008 has been given to CMS by pressing the AT1N key (cr its 

00010 equivalent). Such connands are processed iaaediately upcn 
00011 entry at the console or on being 'stacked* by an EXEC 

00012 procedure. Any prograa execution ia progress is r ^Lnended 
00013 until the iaaediate coaaand is processed. The ccaaa. .j are 

00014 HO (halt SVC tracing)* HT (halt typicg), NX (halt 

00001 execution)* and NT (resuae typing). 
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CLHO 

00009 

i!2 



CLHO 

00012 

The HO coaaand aay be issued during 

the execution of 

a 

CLHO 

00013 

coaaand or user prograa to stop the 

recording cf trace 

CLHO 

00014 

information. In order for the HO coaaand 

to be recognized 

it 

CLHO 

00015 

must be entered after stopping program execution by 

an 

CLHO 

00016 

Attention interrupt. Prograa execution 

continues to 

its 

CLHO 

00017 

normal completion, and all recorded trace infcraaticn 

is 

CLHO 

00018 

spooled to the printer. 




00020 

*..... - ..—i 





| HO | | 





i— .1 




CLHO 

00026 

Besppqseff 

CLHX 

00001 

None. 
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CLHX 

00008 

SI 




CLHX 

00011 

The HX coaaand causes the execution 

cf any CHS ccaaand cr 

CLHX 

00011 

user pcograa executing under CHS to 

stop 

, closes 

any open 

CLHX 

00012 

files or I/O devices , and returns 

the 

user to 

the CBS 

CLHX 

00013 

coaaand environaent. In order for 

the 

HX coaaand to be 

CLHX 

00014 

recognized, it aust be issued after • 

stopping 

prograa 

CLHX 

00015 

execution by an Attention interrupt. 




CLHX 

00017 

» 1 ... -— -.i 




CLHX 

00018 

1 HX | | 




CLHX 

00019 





CLHX 

00023 

Responses 





CLHT 


00001 


No 00 
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CLHT 

00008 

£2 

CLHT 

CLHT 

CLHT 

CLHT 

CLHT 

CLHT 

CLHT 

CLHT 

CLHT 

00011 

00012 

00013 

00014 

00015 

00016 

00016 

00017 

00019 

The HT command causes all terminal output generated by the 
CHS command or user program in progress to be suppressed. In 
order to enter the HT command meaningfully, an Attention 
interrupt must be simulated by pressing the ATTN Key. 
Program execution continues, but the keyboard is urlocxed tc 
accept user input which is stacked and leld until the 
current command completes. Execution continues tc uccxal 
program completion. When the READ! message is typed out, 
normal terminal output resumes* 

CLHT 

CLHT 

CLHT 

00021 

00022 

00023 

i-—-- — ■ ■ .. -■» 

| HT j | 

4_ * 

CLHT 

00027 

Responses 

CLRT 

00001 

Hone. 
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CLBT 

00008 

CLRT 

oooit 

CLRT 

00012 

CLRT 

00013 

CLRT 

00013 

CLRT 

00014 

CLRT 

00015 

CLRT 

00017 


CLRT 

00019 

CLRT 

00020 

CLRT 

00021 

CLBT 

00025 


fil 


The BT coaaand restores terainal typeout free an executing 
CMS coaaand or user prograa that was previously suppressed 
by the HT coaaand. In order to enter the HT coaaand 
meaningfully, an Attention interrupt aust fce siaulated ty 
pressing the ATTN key. Prograa execution continues, acd 
previously suppressed typeout continues. Execution continues 
to noraal prograa coapletion. 


! HT | 

A 



flasEgaaaa 


CLPRIVCL 00005 


Rone 
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CLPRIVCL 


CLPHIVCL 


CLPHIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 


CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPHIVCL 

CLPRIVCL 


00008 £E_£2MAHfiS 


00012 C£ Elimsss CLASSSS 


00013 The CP commands are divided into eight groups, each being 
00014 represented by a privilege class which indicates the source 
00015 from which the commands will be accepted. Each user is 
00016 assigned, as part of his entry in the user directory, one or 
00017 aore privilege classes* Figure 27 shows the function of each 
00018 class and Figure 28 shows the conaands which are accepted 
00019 froa users in each class. 


00026 
00027 
n 0028 
00029 
00030 
00031 
00032 
00033 
00034 
00035 
00^36 
00037 
00038 
00039 
00040 
0^041 
00042 
00043 
00044 
00045 
00046 
00047 
00048 
00049 
00050 
00051 
00052 
00053 
00054 
00055 
C0056 
00057 
00058 
00059 
00060 

00062 Pigure 27, CP Privilege Class Descriptions 


Systea Operator: The function of the Class A user 
is to control the VH/370 systea. Class A is 
assigned to the user who is controlling the CPU 
console typewriter at VH/370 IPL tine. 

Note: The Class A Systems Operator who is autc- 
aatically logged in at CP initialization is 
designated as the Primary Sy ste a Operator. 

Svs tea R esource Operator : The function of the Class 
B user is to control the real resources of the 
Systen/370 computer. 

Sys tea P roqraa aer: The function of the Class C user 
is to naintain and aodify certain functions of the 
VH/370 systea. 

Spooling Operator: The function of the Class D user 
is to control the systea unit record equipment and 
the spool data files. 

Sys tea Analyst: The function of the Class E user is 
to examine certain data in the VM/37C storage area. 

Ser vice Representati ve: The function of the Class F 
user is to obtain and exaaine in detail certain 
data about input/output devices connected to the 
Systan/370 computer. 

G enera l Usej:: The function of the Class G user is 
to control functions associated with the execution 
of his virtual machine. 

reserved for future use. 
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CLPRIVCL 

CLPRIVCL 

CLPBIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 

CLPRIVCL 


00066 
00067 
00068 
00069 
00070 
00071 
00072 
00073 
00074 
00075 
00076 
00077 
00078 
00C79 
00080 
00081 
00082 
00083 
00084 
00085 
00086 
00087 
00088 
0 0089 
00090 
00091 
00092 
00093 
00094 
00095 
00096 
00097 
00098 
00099 
00100 
00101 


ALL 

A 

B 


DIAL, DISCONN, LOGIN, LOGOUT, MSG, QUERY LCGMSG, 
QUERY NAMES, QUERY userid, QUERY USERS, SLEEP, * 

ACNT, DISABLE, ENABLE, FORCE, HALT, LOCK, QUERY 
PAGING, QUERY PRIORITY, SET FAVORED, SET PAGING, 

SET PRIORITY, SET RESERVE, SHUTDOWN, UNLOCK, WNG 

ATTACH, ATTACH CHANNEL, DETACH, DETACH CHANNEL, 
DISABLE, ENABLE, MSG ALL, QUERY DASD, QUERY 
DUMP, QUERY LINBS, QUERY raddr, QUERY STORAGE, 

QUERY SYSTEM, QUERY TAPE, QUERY UR, SET CUHI, SET 
LOGMSG, VARY, HHG 

STCP 

BACKSPAC, CHANGE, DRAIN, FLUSH, FREE, HOLE, LCAEBU F 
ORDER, PURGE, QUERY FILES, QUERY HOLE, QUEBY 
PRINTER, QUERY PUNCH, QUERY READER, REPEAT, SPACE, 
START, TRANSFER 

DCP, DHCP, LOCATE, QUERY PAGING, QUEFY PRICFITY, 
SAVESYS 

SET RECORD 

ADSTOP, BEGIN, CHANGE, CLOSE, COUPLE, DEFINE, 
DETACH, DISPLAY, DUMP, ECHO, EXTERNAL, Ifl, LINK, 
NOTREADY, ORDER, PURGE, QUERY FILES, QUERY LINKS, 
QUERY PRINTER, QUERY PUNCH, QUERY REDDER, QUERY 
SET, QUERY TERMINAL, QUERY TIME, QUEBY VIRTUAL, 
READY, RESET, REMIND, SET ACNT, SET EESG, 

SET LINEDIT, SET MSG, SET NOTRAN, SET RUN, SET 
TIMER, SET MNG, SPOOL, STORE, SYSTEM, TERMINAL, 
TRACE, TRANSFER, LOADVFCB 


00103 Figure 28, Coaaands Used by Each Privilege class 
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CLCPINT 00005 ££ CO MMAND SUM MAB? 


CLCPINT 00007 This section contains descriptions of the commands 

CLCPINT 00008 acceptable in the control program environment. Figure 29 

CLCPINT 00^09 presents an alphabetical list of the commands, the privilege 

CLCPINT 00009 classes which aay execute the command, and a brief stateaent 

CLCPINT 00010 about the U 3 a of each command. 

CLCPINT 00017 i--- 1 

CLCPINT 00018 | | PHI? | | 

CLCPINT 00C19 | COMMAND | CLASS J USAGE | 

CLCPINT 00020 |-1-1-| 

CLCPINT 00021 I * j ALL jannotate the console sheet I 

CLCPINT 00022 III I 

CLCPINT 00023 I ACNT j A jcreate accounting records for logged | 

CLCPINT 00024 I j | on users and reset accounting data | 

CLCPINT 00025 ill I 

CLCPINT 00026 | ADSTOP | G |halt execution at a specific virtual | 

CLCPINT 00027 | I | machine instruction address I 

CLCPINT 00028 III I 

CLCPINT 00029 j ATTACH | B jattach a real device to a virtual I 

CLCPINT 00030 | j | machine | 

CLCPINT 00031 I | (attach a DASD device foi CP ccntrol | 

CLCPINT 00032 | | (dedicate all devices on a particular | 

CLCPINT 00033 j j j channel to a virtual machine j 

CLCPINT 00034 III I 

CLCPINT 00035 | BACKSPAC | D (restart or reposition the output of a | 

CLCPINT 00036 . | j j spooling device I 

CLCPINT 00037 I | | | 

CLCPINT 00038 | BEGIN j G (continue or resume execution of the | 

CLCPINT 00039 j j j virtual machine at either a specific| 

CLCPINT 00040 | | | storage location or at the address | 

CLCPINT 00041 j j I in the current ESN 1 

CLCPINT 00042 III | 

CLCPINT 00043 | CHANGE j D,G |alter one or more external attributes | 

CLCPINT 00044 | j j of a closed spool file J 

CLCPINT 00045 III | 

CLCPINT 00046 | CLOSE J G (terminate spooling operations cn a | 

CLCPINT 00047 | I j virtual card reader, punch,or printer | 

CLCPINT 00048 | | | ( 

CLCPINT 00049 I COUPLE j G (connect channe1-to-channel adapters | 

CLCPINT 00050 III | 

CLCPINT 00051 j DCP j E (display real storage at terminal I 

CLCPINT 00052 IIS | 

CLCPINT OO 053 I DEFINE j G (reconfigure a virtual machine I 

CLCPINT C0054 •- j 

CLCPINT 00056 Pigure 29. CP Command Summary (Part 1 of 4) 


COMMAND 


ADSTOP 


BACKSPAC 


PHI? 

CLASS 


annotate the console sheet 

create accounting records for logged 
on users and reset accounting data 

halt execution at a specific virtual 
machine instruction address 

attach a real device to a virtual 
machine 

attach a DASD device for CP ccntrol 
dedicate all devices on a particular 
channel to a virtual machine 

restart or reposition the output of a 
spooling device 

continue or resume execution of the 
virtual machine at either a specific 
storage location or at the address 
in the current ESN 

alter one or more external attributes 
of a closed spocl file 

terminate spooling operations cn a 
virtual card reader, punch,cr printer 

connect channe 1 -to-channel adapters 

display real storage at terminal 

reconfigure a virtual machine 
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CLCPINT 00059 
CLCPINT 00060 
CLCPINT 00061 
CLCPINT 00062 
CLCPINT 00063 
CLCPINT 00064 
CLCPINT 00065 
CLCPINT 00066 
CLCPINT 00067 
CLCPINT 00068 
CLCPINT 00069 
CLCPINT 00070 
CLCPINT 00071 
CLCPINT 00072 
CLCPINT 00073 
CLCPINT 00074 
CLCPINT 00075 
CLCPINT 00076 
CLCPINT 00077 
CLCPINT 00078 
CLCPINT 00079 
CLCPINT 00080 
CLCPINT 00081 
CLCPINT 00082 
CLCPINT 00083 
CLCPINT 00084 
CLCPINT 00085 
CLCPINT 00086 
CLCPINT 00087 
CLCPINT 00088 
CLCPINT 00089 
CLCPINT 00090 
CLCPINT 00091 
CLCPINT 00092 
CLCPINT 00093 
CLCPINT 00094 
CLCPINT 00095 
CLCPINT 00096 
CLCPINT 00097 
CLCPINT 00098 
CLCPINT 00099 
CLCPINT 00100 
CLCPINT 00101 
CLCPINT 00102 
CLCPINT 00103 
CLCPINT 00104 
CLCPINT 00105 
CLCPINT 00106 
CLCPINT 00107 
CLCPINT 00108 

CLCPINT 00110 Figure 29. CP Command Summary (Part 2 of 4) 


COMMAND 

t PB1V 
j CLASS 

1 

| USAGE 

DETACH 

1 B,G 
i 

1 

1 

1 

1 

|disconnect a real device ftci e 

| virtual aachine 

jdetach a DASD device free CP 

j detach a channel fronr a specific user 

(detach a virtual device ftca a virtual 

1 aachine 

DIAL 

1 

| ALL 

1 

1 

(connect a terninal to virtual aachine 
f virtual communication line 

DISABLE 

I a,b 

1 

|disable communication lines 

ft 

DISCOMM 

1 

9 ALL 

8 

1 

(disconnect user v s terairal ftca a 
j virtual machine 

0 

DISPLAY 

i 

1 G 

1 

(display virtual storage on user's 
i terminal 

8 

DMCP 

1 

1 B 

1 

1 

(dump real storage on user's virtual 

8 printer , 

1 

DBA IN 

1 

1 D 

8 

1 

fl 

1 

|halt operations of specified spool 
j devices upon conpleticn of current 
( operation 

DUMP 

1 

1 G 

1 

1 

1 

1 

1 

(print on virtual printer: virtual PSH. 
j general registers, floating-point 
( registers, storage keys, and 
| contents of specified virtual 
( storage locations 
(1 

ECHO 

1 

1 G 

t 

(test terminal hardware 

fl 

ENABLE 

1 A* B 

1 

tenable communication lices 
| 

EXTEBNAL 

1 G 

1 

1 

(simulate an external interrupt for a 

I virtual machine and return ccntrcl 
( to that machine 

FLUSH 

1 

1 D 

8 

I ) 

(cancel output on a specific real unit 
| record device 

POBCB 

1 A 

1 

(cause logout of a specific user 

A 

FBEE 

1 

| D 

9 

(remove spool HOLD status 
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CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 


00113 

00114 

00115 

i 

1 

| COMMAND 

| PHIV 
| CLASS 

| USAGE 

1 

00116 

|- 




00117 

| HALT 

1 A 

(terminate the active channel program 


00118 

1 

1 

j on specified real device 


00119 

1 

1 

I 


00120 

| HOLD 

1 D 

|defer real spooled output of a 


00121 

9 

9 

| particular user 


00122 

9 

I 

1 


00123 

| IPL 

1 6 

(simulate IPL for a virtual sachine 


00124 


1 

1 


00125 

| LINK 

1 G 

(provide access to a specific DASC 


00126 

1 

1 

( device by a virtual machine 


00127 

1 

1 

1 


00128 

| LOADS OF 

) D 

(load real UCS or FCB printer buffer 


00129 

I 

1 

1 


00130 

| LOADVPCB 

i G 

(load virtual forms control buffer 


00131 


9 

i 


00132 

S LOCATE 

i e 

(find control blocks 


00133 

1 

1 

1 


00134 

| LOCK 

1 A 

(bring virtual pages intc real storage 


00135 

1 

1 

I and lock them thus excluding them 


00136 

1 

1 

( from future paging 


00137 

1 

1 



00138 

1 LOGIN 

| ALL 

(provide access to CP 


00139 

1 

1 

1 


00140 

| LOGOUT 

| ALL 

(disable access to CP 


00141 





00142 

| MSG 

| B,ALL 

(transmit messages from user tc user 


00143 

f 

! 



00144 

| NOTBEADY 

9 G 

(simulate 'not ready* for a device to 


00145 

s 

9 

| a virtual machine 


00146 

1 

| 

1 0 


00147 

| ORDEB 

8D,G 

(rearrange closed spool files in a 


00148 

1 

1 

j specific order 


00149 

1 


1 


00150 

| PURGE 

1 D,G 

(remove closed spool file frca system 


00157 

1 

1 



00152 

| QUEBY 

1 A,B # D 

jreguest information about machine 


00153 


|E,G,ALL| configuration and system status 


00154 

1 

1 

I 


00155 

I BEADY 

i G 

(simulates device end interrupt tc 


00156 

1 

1 

( specified virtual address 


00157 


i 



00158 

| BEPEAT 

1 D 

(repeat printing or punching cf current 


00159 



| real spool output file 


00160 

1 

9 



00161 

| BESET 

| G 

(clear and reset all pending interrupts 


00162 

1 

1 

j for a specified virtual device and 


00163 



j reset all error conditions 


00164 

l_ 


_ - - _ _ — 

J 


00166 Figure 29. CP Command Summary (Part 3 of 4) 
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CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 

CLCPINT 


00169 

00170 

00171 

00172 

00173 

00174 

00175 

00176 

00177 

00178 

00179 

00180 

00181 

00182 

00183 

00184 

00185 

00186 

00187 

00188 

00189 

00190 

00191 

00192 

00193 

00194 

00195 

00196 

00197 

00198 

00199 

00200 

00201 

00202 

00203 

00204 

00205 

00206 

00207 

00208 

00209 

00210 

00211 

00212 

00213 

00214 

00215 

00216 

00217 

00218 

00219 

00220 


1—-■— 

| COMMAND 

| PRIV 
| CLASS 

——————— ----i 

I 1 

| USAGE 1 

| BEHIND 

1 G 

|per fora operation equivalent tc 1 

| rewinding and readying a tape I 

| SAVESTS 

t 

i E 

1 

* 

t A,B,F, 

(save virtual aacbine aeiory space, 9 

j registers, and PSU 1 

| SET 

1 i 

G|operator - establish systea patanetersl 

laser - control various functions j 

I within the virtual systea j 

| SHUTDOWN 

1 

1 A 

9 

iterainate all CP functions and check- | 
J point CP systea for wara start | 

| SLEEP 

1 

i ALL 

|place virtual aachine's teriinal in | 

| doraant state with keyboard locked | 

| SPACE 

■ 

| D 

I • 

(force single spacing on printer 1 

| SPOOL 

1 

1 G 

1 * 
falter spooling control option 1 

| START 

1 

1 D 

1 

i 9 
| start spooling device after draining | 
j or changing output classes 1 

| STCP 

1 

I c 

l i 

fallow alteration of real storage I 

j STORE 

9 

1 G 

1 1 
falter specified virtual storage and | 

1 registers 1 

| SYSTEM 

1 

1 G 

1 

|siaulates RESET, CLEAR STORAGE and | 

j RESTART buttons on console I 

| TERMINAL 

1 

1 G 

1 1 
(control terainal I/O processing I 

i TRACE 

1 

I G 

I 

1 

1 9 
(trace specified virtual lacfaine activ-l 
| ity at the terainal, spooled printeri 
| or both 9 

| TRANSFER 

1 D,G 

1 

j direct spooled files to specified 1 

| user's card reader 1 

j UNLOCK 

1 

1 A 

1 I 

(unlock previously locked page fraaes | 

| VARY 

1 

1 B 

1 

jaark a device unavailable or available! 
| to CP I 

j VUG 

t ..— 

i a,b 

1 • 
Itransait a high priority aessage to a | 
j specified user or to all users 1 

a —..... - ... J 


00222 Figure 29. CP Coaaand Suaaary (Part 4 of 4) 
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CLCPEHB 


CLCPBRB 

CLCPEBR 

CLCPEHB 

CLACMT 


00006 C£ E££ 2 £ Messages and fiesp ongeq 


00000 Refer to IBM Virt ual E&shifla EasilltXZlZiU Sistea jj£ssa.g£s 
00009 (Order No. GC20-1808) for a description cf the aessages 
00010 produced by the CP coaaands. All aessages froa CP coaaaads 
00001 have the prefixes DMK. 
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CLACBT 

00007 

CLACNT 

00010 


CLACNT 

00011 

CLACNT 

00012 

CLACNT 

00013 

CLACNT 

00014 

CLACNT 

00016 

CLACNT 

00017 

CLACNT 

00018 

CLACNT 

00019 

CLACNT 

00019 

CLACNT 

00021 

CLACNT 

00030 

CLACNT 

00031 

CLACNT 

00032 

CLACNT 

00033 

CLACNT 

00039 

CLACNT 

00041 

CLACNT 

00044 

CLACNT 

00045 


CLACNT 

00048 

CLACNT 

00050 

CLACNT 

00052 

CLACNT 

00057 

CLACNT 

00057 

CLACNT 

00058 

CLACNT 

00059 

CLACNT 

00062 

CLACNT 

00063 

CLACNT 

00066 

CLACNT 

00066 

CLACNT 

00067 

CLACNT 

00067 

CLACNT 

00068 

CLADSTOP 

00001 


ASM 


ECllilege £iass: A 


The ACNT conaand produces for each user specified, an 
accounting record giving the tiae used' ky his victual 
■achine since the last ACNT coaaand was issued for hia or 
since he logged in. The record produced is identical to the 
record given when the user logs out of VH/37C. Each user 
receives a aessage at his terainal giving the accuaulatcd 
accounting data, and the accuaulated accounting data for 
each user is reset. A user can prevent his terainal frca 
receiving the accounting aessage by having entered the CP 
coaaand SET ACNT OFF. 

i---1 

| ACNT i ( useridl userid2. .. ) | 

I I C ALL } I 

» _i 

userid specifies the users for which accconting records 
are to be created. 

ALL specifies that accounting records are to be 

created for all logged-on users. 


MSfi09§es 


Poraat of accounting inforaation aessage: 


CONNECT’ 

■hh: aa: ss 

VI8TCPU=aaa:ss.hh TOTCPU=taa:ss.hh 

CONNECT 

hh:aa:s3 

the actual clock tiae spent in the 
user's current terainal session or the 
tiae elapsed since the ACNT coaaand was 
last Issued for the user. 

VI BTCPO 

aaa:ss. hh 

the CPO tiae spent in executing 

instructions within the virtual machine. 

TOTCPO 

aaa:ss. hh 

the CPO tiae spent in executing 
instructions within the virtual aachine 
plus CPU tiae used ky the control 
prograa in aaintaining the virtual 
■achine {paging, I/O, and so forth). 

CONHAND 

COHPLSTE 
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I 


CLADSTOP 00003 AfiSlfifi 


CLADSTOP 00006 E£ilil£a£ C^ as3: G 


CLADSTOP 00008 
CLADSTOP 00009 
CLADSTOP 00010 
CLADSTOP 00011 


The ADSTOP connand specifies a virtual instruction address 
where execution is to be halted* Execution halts when the 
instruction at the specified address is the text instruction 
to be executed. 


CLADSTOP 00012 
CLADSTOP 00014 
CLADSTOP 00016 
CLADSTOP 00017 
CLADSTOP 00018 


At the tine execution halts, CP console function mode is 
entered and a message is typed. At this point the user nay 
invoke other CP debugging ccanands. To resune operation of 
the virtual nachine, the BEGIN connand can be issued* Once 
an ADSTOP location is set, it nay be removed by: 


CLADSTOP 00022 1* reaching the virtual storage location specified in the 

CLADSTOP 00023 ADSTOP connand 


CLADSTOP 00026 
CLADSTOP 00030 


2. performing a virtual IPL or SYSTEM BESET, 

3. issuing the ADSTOP OFF connand, or 


CLADSTOP 00033 
CLADSTOP 00034 


4. specifying a different location with a new ADSTCP 
hexloc connand. 


CLADSTOP 00044 
CLADSTOP 00045 
CLADSTOP 00046 
CLADSTOP 00047 


1 ADSTOP | 
1 I 


( hexloc } 
( OFF } 


CLADSTOP 00054 hexloc 
CLADSTOP 00055 
CLADSTOP 00056 
CLADSTOP 00057 
CLADSTOP 00058 
CLADSTOP 00059 


is the address, specified in hexadecinal digits, 
of the virtual nachine instruction where execution 
i3 to be halted. An address stop locaticn cannct 
be specified at a virtual address that is in a 
segnent shared with other users, since the ADSTCP 
function nodifies storage. 


CLADSTOP 00061 OFF 
CLADSTOP 00062 


specifies that any previous ADSTOE setting is to 
be cancelled. 


CLADSTOP 00064 

CLADSTOP 00065 
CLADSTOP 00066 
CLADSTOP 00067 
CLADSTOP 00068 


flote: Since the ADSTOP function nodifies storage (by placing 
a CP SVC I'B3' at the specified location) the user*s progran 
should not axanine the two bytes at the instruction address. 
CP does not verify that the location specified ccntains a 
valid CPU instruction. 
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CLADSTOP 


CLADSTOP 

CLADSTOP 

CLADSTOP 

CLADSTOP 

CLADSTOP 

CLATTACH 


00071 

Baafiaasas 


00073 

ADSTOP AT xxxxxx 


00075 

00076 

00077 

00078 

00001 

The instruction whose address is xxxni is 

instruction scheduled for execution. The virtual 
in a stopped state. The CP conaand BEGIN nay te 
to resuae execution at the instruction location 
at any other location desired. 

the next 
aachine is 
te enteced 
xxxxxx. or 
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CLATTACH 


CLATTACH 


CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 

CLATTACH 


CLATTACH 


CLATTACH 


00003 ATTA CH 

00006 Pri vi lege class: B 


00009 The ATTACH command is used to logically connect a real 
00010 device to a virtual aachine for that virtual machine’s 
00011 exclusive use, or to logically connect a DASD device tor CP 
00012 access and control. 

00023 ,-----t 

00024 j ATTACH | raddr [TO] (userid [AS] vaddr [H/O] ] ] 

00025 | ATT | (SYSTEM [AS] volid } J 

00026 «----- J 


"0033 raddr 


real address (ecu) of the device to he attached. 


00036 TO 
00037 T 
00038 


is an optional reserved keyword. If this word is 
omitted and userid is specified, tserid cannct be 
"TO” or **T". 


00041 

00042 

00043 

00043 

00045 


userid is the user identification cf the virtual aachine 
that is to receive the device. The user must be 
logged in to receive the device, userid can be 
specified as asterisk (*) if the operator is 
attaching the device to his own virtual aachine. 


00048 AS 

00049 A 

00051 


is an optional reserved keyword. If this word is 
omitted, vaddr, if specified, cannot be "A", and 
the volid, if specified, cannot be ’•AS" or "A". 


00053 vaddr is the virtual address (ecu) to be assigned to the 
"0054 device. 


00057 8/0 

00058 R 

00059 
00060 


is optionally used for DASD devices that are 
attached to a user. This allcws the system 
operator to apply read-only protection to a user’s 
disk. 


00063 SYSTEM 

00063 

00065 


this specification, along with velid, makes the 
DASD device available to CP for accessing users 
disks and/or for paging and spooling functions. 


00067 volid is the volume label of the disk to be attached for 
00068 use by CP. This label will be verified before 
00070 attachment of the device. 


00074 Resp o nses 

00076 Messages are sent to the user, the operator who issued the 
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CLATTACH 00077 coaaand (if different froa the user), and the priaazy ayatea 
CLATTACH 00078 operator (if different froa the operator who issued the 
CLATTACH 00080 coaaand), notifying then that the ATTACH was successful. 


CLATTACH 00083 type vaddr ATTACHED 

CLATTACH 00085 is the response to the user indicating that the ceai device 
CLATTACH 00085 represented by address vaddr has been attached to his 
CLATTACH 00086 aachine. 


CLATTACH 00088 type raddr ATTACH TO userid vaddr 
CLATTACH 00089 or 

CLATTACH 00091 type raddr ATTACH TO SYSTEM volid 

CLATTACH 00093 is the.response to the Class B user who issued the coaaand 

CLATTACH 00094 indicating that the real device represented by address raddr 
CLATTACH 00095 has been attached either to the user's virtual aachine at 
CLATTACH 00096 virtual address vaddr or to CP. 


CLATTACH 00098 type raddr ATTACH TO SYSTEM volid BY userid 
CLATTACH 00100 or 

CLATTACH 00102 type raddr ATTACH TO userid vaddr BY userid 

CLATTACH 00104 is the response to the priaary systea operator (if he did 

CLATTACH 00105 not issue the coaaand) indicating that the real device has 

CLATTACH 09106 been attached either to the specified user's aachine at 

CLATTACH 00107 virtual address vaddr or to the CP systea by the specified 

CLATTACH 00108 Class B user. 


CLATTACH 00111 In the above responses 'type' is one of the fcllcwing: 

CLATTACH 00114 DASD Direct access storage device 

CLATTACH 00115 TAPE Magnetic tape 

CLATTACH 00116 LINE Coaaunication line 

CLATTACH 00117 BDH Card reader 

CLATTACH 00118 PHT Line printer 

CLATTACH 00119 PON Card punch 

CLATTACH 00120 GBAF Graphics device 

CLATTACH 00121 CONS Console 

CLATTACH 00122 CTCA Channel-to-channel adapter 

CLATTACH 00123 DEf Any other device 
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CLATCHAN 


CLATCHAN 


CLATCHAN 

CLATCHAN 

CLATCHAN 

CLATCHAN 

CLATCHAN 

CLATCHAN 

CLATCHAN 

CLATCHAN 


CLATCHAN 

CLATCHAN 

CLATCHAN 

CLATCHAN 


CLATCHAN 

CLATCHAN 

CLATCHAN 

CLATCHAN 

CLATCHAN 

CLATCHAN 

CLATCHAN 

CLATCHAN 

CLATCHAN 

CLATCHAN 

CLATCHAN 

CLATCHAN 


CLATCHAN 


CLATCHAN 

CLATCHAN 

CLATCHAN 

CLATCHAN 

CLATCHAN 


00003 AXI&Sii SJJAflJifii 


00006 fiiiilsaa ci§§§: b 


00008 The ATTACH CHANNEL command dedicates all devices on a 
00010 particular channel to a specified user. The addresses by 
00011 which the virtual aachine user refers to these devices aust 
00012 be the sane as the real addresses. The devices cn the 
00013 attached channel do not have to be individually attached to 
00014 the virtual user; he nay use any or all of the devices. The 
00015 virtual aachine aust have all I/O stopped before executing 
00016 ^ the coaaand. 


00026 ' ,-■---, 

00027 | ATTACH | CHANNEL c [TO] usefid | 

00028 | ATT | | 

00029 *-- > 


00037 CHANNEL required reserved word 


00039 c 
00040 


is the real address of the channel to he attached 
to the user. 


00044 TO 

00046 T 


Is an optional reserved keyword. If tbie word 
is not specified, the userid cannot be "T or "TC". 


00050 

00051 

00051 

00052 

00053 

00053 

00054 


userid is the user identification of the virtual aachine 
that is to use the dedicated channel. The user 
aust be logged in in order to receive the 
channel. userid can be specified as asterisk (*) 
to indicate that tbe channel Is tc be attached to 
the virtual aachine of the operator issuing the 
coaaand. 


00057 Besp o nses 

C 

00059 Messages are sent to the user to whoa the channel is 

00060 attached, and to the operator who issued the command. 

00062 CHANNEL c ATTACHED 

00063 is the response to the user who receives dedicated access fc 

00064 the channei. 
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CLATCHAN 

CLATCHAN 

CLATCHAN 

CLATCHAN 

CLATCHAN 


00067 CHANNEL c ATTACH TO userid 

00069 is the response to the operator who issued the cceeand. 

00071 CHANNEL c ATTACH TO userid BT operator 

00072 is the response to the priaary spates operator if he did net 
00073 issue the cosaand. 
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CLBACKSP 00003 


CLBACKSP 00006 EEAlAIaSJg SilSSI D 


CLBACKSP 00008 The BACKSPAC coaaand restarts or repositions the current 

CLBACKSP 00009 output on a real punch or printer. 


CLBACKSP 00019 Printer BACKSPAC Foraat Punch BACKSPAC Fcraat 


CLBACKSP 00021 ,-i i---- '—t 

CLBACKSP 00022 | trill I I 
CLBACKSP 00023 | BACKSPAC | raddr | FILE | t J BACKSPAC t laddr [£ILE] I 
CLBACKSP 00024 | BA J Jpages| | j BA I I 
CLBACKSP 00025 j I | 1-14 I I I 
CLBACKSP 00026 I I L J I I I I 
CLBACKSP 00027 «-J »- J 


CLBACKSP 00033 raddr is the address (cuu) of the real unit record 
CLBACKSP 00035 device which is to be backspaced. This address 
CLBACKSP 00036 aust be that of a punch or a printer. 

CLBACKSP 00039 FILE specifies that the output spool printer cr punch 
CLBACKSP 00042 F file is to be restarted free the beginning. 

CLBACKSP 00045 pages specifies the nuaber of pages to he backspaced cn 
CLBACKSP 00045 the printer. If the field is not specified, the 
CLBACKSP 00046 printer is backspaced to the beginning cf the page 
CLBACKSP 00047 being printed when the coaaand is received, 

CLBACKSP 00051 Note : If the BACKSPAC coaaand is issued while an 
CLBACKSP 00052 intervention required condition is pending on the printer cr 
CLBACKSP 00053 punch, the interrupted channel prograa is terainated and the 
CLBACKSP 00054 backspace is perforaed. 

CLBACKSP 00056 A BACKSPAC coaaand for a punch is always treated as a 
CLBACKSP 00057 BACKSPAC FILE. 

CLBACKSP 00058 No£e: Pages for backspacing are counted starting from the 
CLBACKSP 00059 end of the current spooling buffer. Output containing a 
CLBACKSP 00061 snail nuaber of lines per page aay require a count cf acre 
CLBACKSP 00062 than one to backspace one page. 

CLBACKSP 00064 Pages are counted in BACKSPAC operations by looking for skip 
CLBACKSP 00064 to channel 1 specifications (page ejects). If a file dees 
CLBACKSP 00065 not contain skip to channel 1 specifications, processing of 
CLBACKSP 00066 the file will be restarted regardless of the nuaber of pages 
CLBACKSP 00068 indicated. Counting begins at the end cf the current buffer. 
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CLBACKSP 


CLBACKSP 

CLBACKSP 

CLBACKSP 

CLBACKSP 

CLBEGIN 


00072 

Responses 




00076 

( PUT ) raddr 

BACKSPACE userid FILE = 

spoolid 

00C77 

( pou 1 



00080 

raddr is the 

real 

device address 

and userid is the 

00081 

id an t if ication 

of the 

user whose file 

(spooli'd) vas active 

00001 

and backspaced. 
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CLBEGIN 00003 JJ&LEN 


CLBEGIN 00006 Priv i lege Class: G 


CLBEGIN 00009 The BEGIN coaaand continues or resuaes execution of the 
CLBEGIN 00010 user's virtual aachine at either a specified storage 

CLBEGIN 00010 location or the location pointed to by the virtual nachines 

CLBEGIN 00011 current PSW. 

CLBEGIN 00020 ,---•, 

CLBEGIN 00021 | BEGIN | [hexloc ] 1 

CLBEGIN 00022 | B | f 

CLBEGIN 00023 •- 

CLBEGIN 00029 hexloc 

CLBEGIN 00031 

CLBEGIN 00032 

CLBEGIN 00035 

CLBEGIN 00037 

CLBEGIN 00038 

CLBEGIN 00039 

CLBEGIN 00040 


CLBEGIN 00043 Besnonses 


CLCHANGE 00001 None* The virtual aachine begins execution. 


is the storage location, specified in hexadecinal 
digits, at which execution is tc begin. If no 
location is specified, execution resunes at the 
location contained in the virtual aachine current 
PSW, This would be the location at which the 
virtual aachine was stopped when CP was last 
entered, unless the PSW had been altered since 
that tine. 
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CLCHANGB 00005 QiMfiJB 

CLCHANGB 00007 EfiililsaS ?^ ass; D,G 


CLCHANGB 00009 
CLCHANGB 00010 
CLCHANGB 00011 
CLCHANGB 00012 
CLCHANGB 00013 
CLCHANGB 00015 
CLCHANGB 00016 
CLCHANGB 00017 


The CHANGE coaaand alters one or aore of the external 
attributes of a closed spool file or files'. The current 
attributes of a file aay be determined by issuing a CUEBY 
coaaand. In order to change an output file, the file oust 
have been closed but not yet selected for printing or 
punching. An input (BBADEB) file aay be changed at any tine 
before it is opened, that is before the first read is issued 
for the file. 


CLCHANGE 

00028 

r* 

-.. ■■■ ■■ ■■ 



— - -.. - . 

.. -... 

—i 

CLCHANGB 

00029 

i 


t 

(CLASS a) 


i 


CLCHANGB 

00030 

1 

CHANGE | 

( READER 

(spoolid) 

CLASS b 

) 


CLCHANGB 

00031 

1 

CH j 

( 

(ALL } 


) 


CLCHANGE 

00032 

S 

1 

c 



) 


CLCHANGB 

00033 

1 

j[ userid] 

( 



) [ NAME (f n [ft])) 


CLCHANGB 

00034 

i 

|( SYSTEH ] 

( 



j( ( dsnaae)] 


CLCHANGB 

00035 

i 


{ 



) 


CLCHANGB 

00037 

1 


( (PRINTER) 

(CLASS a) 

(CLASS b } 

*} 


CLCHANGB 

00038 

J 

1 

((PUNCH J 

(spoolid) 

(COPY nn ) 

) 


CLCHANGB 

00039 

1 


C 

(ALL ) 

{( HO ID | NCHCID ]} 

) 


CLCHANGE 

00C4 0 

1 

1 

C 


(DIST distccde) 

) 


CLCHANGE 

00041 

1 


( 



} 


CLCHANGE 

00042 

«_ 



.. 

_ t 


CLCHANGB 000*5 
CLCHANGB 00046 
CLCHANGB 00047 
CLCHANGB 00048 


* one of these options aust be chosen; however, aore than 
one aay be specified and they aay be coabined in any order. 
This is contrary to the notation ncraall) used in this 
publication. 


CLCHANGB 00053 
CLCHANGB 00054 
CLCHANGB 00055 


userid (for use by Class D users only) this allcws the 
spooling operator to manipulate the s^ccl files 
for a particular user. 


CLCHANGB 00057 
CLCHANGB 00058 
CLCHANGB 00059 


STSTEH (for use by Class D users cnly) this allows the 
spooling operator to manipulate all sped files in 
the systea regardless of userid. 


CLCHANGE 00062 
CLCHANGE 00064 
CLCHANGE'00066 


READBB indicates the type of file tc be changed. 
B 

RDR 


CLCHANGE 00068 PRINTBB 

CLCHANGB 00070 P 

CLCHANGB 00072 PRT 


CLCHANGB 00074 P0NCH 

CLCHANGB 00076 PU 

CLCHANGB 00078 PCH 
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CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 


CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 


CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 


00081 

00083 

00085 

00087 

00088 

CLASS a 
CL 

is used to designate an existing class. A is a ene 
alphanumeric character field from A to Z or £rc> 
0-9. Hefer to Iflfl lijciyai flashing IlSliitiZilC, 
Operators Guide (Order No. GC2C-18C6) rcr a 
detailed description of spool clasres. 

00C93 

00094 

spoolid 

is the spoolid nusber of the file that is tc be 
changed. Bach file has a unigue spoolid. 

00096 

00097 

ALL 

specifies that all files belonging to the user are 
to be changed. 

00100 

00102 

CLASS b 
CL 

is specified to designate the new class of the 
file. 

00104 

00106 

00106 

00108 

NAME 

NA 

is a reserved word which is reguircd if fr, ft, or 
dsnane is to be changed. This is specified .to 
indicate that the nane of the file with the given 
spoolid is to be altered. 

com 

00111 

00112 

fn 

is a 1 to 8 alphameric character nane cf a CBS 
file to be assigned to the file fox identificaticn 
purposes. 

00117 

00117 

00118 

ft 

is a optional 1 to 8 alphameric character field, 
used for further file identification for CMS 
files. 

00120 

00121 

dsname 

a 1 to 24 character field which is used to 
designate a non-CNS file. 

00123 

00124 

00125 

00126 

Note: If the NAME function is selected and only fn is 
specified, ft is set to blanks. The dsname specificaticn 
allows a user to specify a file name suitable for CS or COS 
files such as SI51.SYSLIB.NY MAC. 

00129 

00131 

00132 

00133 

00134 

0^135 

COPT an 
CO 

is specified to alter the number of real copies 
of the file to be made. This option is valid fcr 

printer and punch files only. The value of nn 
(number of copies) must be a number frcm 1 through 
99. For nn less than 10, the leading zero is 
optional. 

00138 

00139 

00140 

HOLD 

HO 

specifies that the file is net tc be printed cr 
punched until released by the user by using the 
nohold parameter. 

00143 

00144 

NOHOLD 

NOH 

specifies that the specified spool file currently 
being held is to be released. 

00145 

fl2£g: 

If a Class D user specifies HOLD cr KCBCLD for 
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CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 

CLCHANGE 


CLCHANGE 


CLCHANGE 

CLCHANGE 

CLCLOSE 


00146 another users spool file, than that file is put in a 
00147 "systen" and "user" HOLD status (or in the case c£ HOHGLD 
00148 specification, released froa both statuses). A sped file 
00149 in a systea HOLD status can only be released (using the FEES 
>10150 or CHANGE coaaand) by a Class D user. 


00153 DIST is a keyword required if the distribution code cf 

00155 DI the file is to be changed. 


10158 

00158 

00159 

00159 

00160 

00161 

00162 


distcode is a 1 to 8 character alphameric identificaticn 
that will appear on the output separators of 
printer and punch output instead of the usual 
identification specified in the eser directory. 
The distribution code is changed for this file 
only, and does not affect other files cr change 
the noraal user code. 


00165 Responses 

00170 (nnnn) FILES CHANGED 

00171 { NO } 

00001 is the response to the user who issued the CfcANGE ccaiand. 
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CLCLOSB 00004 CLO§jj 

CLCLOSE 00006 Privilege Class: G 


CLCLOSE 00008 
CLCLOSE 00008 
CLCLOSE 00009 
CLCLOSE 00010 
CLCLOSE 00010 
CLCLOSE 00011 
CLCLOSE 00012 
CLCLOSE 00013 
CLCLOSE 00014 
CLCLOSE 00014 
CLCLOSE 00015 
CLCLOSE 00016 
CLCLOSE 00017 
CLCLOSE 00017 
CLCLOSE 00018 
CLCLOSE 00019 


The CLOSE command terminates the spooling activity on acy 
virtual spooled unit record device. If the file is an input 
reader file, the file being processed is purged unless the 
user has previously specified SPOOL READER BCLD (See SPOOL 
command). The effect of HOLD or NOHOLD fcr a particular 
file established by the SPOOL command can be overridden by 
specifying NOHOLD OR HOLD, respectively, in the CLOSE 
command. If the file is an output file cn a printer or 
punch, the file is either queued for output cn a real unit 
record device, or, if the virtual output device is 
transferred (SPOOL vaddr TO userid command), tie file is 
queued for input to the receiving user. As optional 
arguments to the CLOSE command for output filer, the user 
nay provide a filename and fileiype and an optional 
distribution code to aid in later identification of the file 
and its contents. 


CLCLOSE 

00C30 


— 

— 


-— 

.. 

-— 

CLCLOSE 

00031 

) CLOSE) 

{ 

(READER) 




} 1 

CLCLOSE 

00032 

) C | 

C 

C ) 

[HOLD)NOHOLD ] 



J t 

CLCLOSE 

00033 

t 1 

( 

(vaddr ) 




J 1 

CLCLOSE 

00034 

) t 

l 


r 



1 

CLCLOSE 

00035 

I 1 

l 

(PRINTER) 

J PURGE 



n i 

CLCLOSE 

00036 


( 

(PUNCH } 

1 r -j 

r 


i) t 

CLCLOSE 

00037 

) 1 

c 

(vaddr ) 

I |HOLD | [DIST distcode] 

| KAEE 

(fn [ft])| 

u j 

CLCLOSE 

00038 

t 1 

( 


| |NOHOLDj 

1 

(dsnaie ) | 

)} i 

CLCLOSE 

00039 

1 1 

c 


L L J 

L 

j 

-*} i 

CLCLOSE 

00040 

«.. 



-- .- •.-.- - ... ■■ 

_ 




CLCLOSE 00046 vaddr is the virtual address (ecu) cf the device to be 
CLCLOSE 00047 closed. The address must represent a reader, 
CLCLOSE 00048 printer or punch. 


CLCLOSE 00052 READER specifies that all devices cf the given type are 

CLCLOSE 00054 R to be closed. 

CLCLOSE 00^56 RDR 


CLCLOSE 00058 PRINTER 
CLCLOSE 00060 P 

CLCLOSE 00062 PRT 

CLCLOSE 00064 PUNCH 

CLCLOSE 00066 PU 

CLCLOSE 00070 PCH 

CLCLOSE 00073 HOLD specifies that the spool file is tc be closed and 

CLCLOSE 00074 HO is not available for further processing unless 

CLCLOSE 00076 specifically requested or changed. This option. 
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CLCLOSE 

00077 


CLCLOSE 

00077 


CLCLOSE 

00078 


CLCLOSE 

00081 

HOHOLD 

CLCLOSE 

00082 

BOH 

CLCLOSE 

00083 


CLCLOSE 

00084 


CLCLOSE 

00085 


CLCLOSE 

00087 


CLCLOSE 

00089 


CLCLOSE 

00089 


CLCLOSE 

00090 


CLCLOSE 

00091 


CLCLOSE 

00091 


CLCLOSE 

00092 


CLCLOSE 

00094 


CLCLOSE 

00C98 

POHGB 

CLCLOSE 

00101 

P0 

CLCLOSE 

00103 


CLCLOSE 

00106 

DIST 

CLCLOSE 

00108 

DI 

CLCLOSE 

00110 

distcode 

CLCLOSE 

00111 


CLCLOSE 

00112 


CLCLOSE 

00112 


CLCLOSE 

00113 


CLCLOSE 

00114 


CLCLOSE 

00114 


CLCLOSE 

00116 


CLCLOSE 

00119 

RARE 

CLCLOSE 

00121 

NA 

CLCLOSE 

00123 

fn 

CLCLOSE 

00125 


CLCLOSE 

00127 

ft 

CLCLOSE 

00129 


CLCLOSE 

09131 

dsname 

CLCLOSE 

00133 


CLCLOSE 

00135 


CLCLOSE 

00136 


CLCLOSE 

00136 


CLCLOSE 

00137 


CLCLOSE 

00139 



specified in the CLOSE command will override any 
previously specified HOLD or KOHOLE option for the 
files being closed. 

specifies that the spool file is tc fce made 
available for further processing. This should 
only be specified if a HOLD established by the 
SPOOL coaaand is still in effect and the current 
active file is not to be held. 

Note: HOLD and NOHOLD have no effect if the output 
file is subsequently transferred tc ancther user. 
An output file that is held can be released by the 
user (or spooling operator) using the CHANGE 
command. An input file that . is held is available 
as a complete spool input file tc any sped reader 
of the virtual nachine. Input files that ace 
closed are normally purged frem the system. 

specifies that the output spool tiles is tc be 
closed and immediately purged from the system. No 
output file is produced. 

is a reserved keyword which is required if 
the distribution code is to be changed. 

is a 1 to 8 character alphameric identification 
that will appear on the output separators c£ 
printer and punch instead ct the usual 
identification specified in the tser directory. 
The distribution code is changed for this file 
only and does not affect other files ci change the 
normal user cods. If the file is transferred to 
another user, this option has no effect. 

is a reserved word which is required if a name is 
to be assigned to the spocl file. 

is a t to 8 alphameric character name tc be 
assigned to the file for identification purposes. 

is an optional 1 to 8 alphanumeric character field 
used for further file identificaticn. 

a 1 to 24 character field which is used to 
designate a non-CHS file. 

N ote :If the NAME function is selected and only fn 
is specified, ft is set to blacks The dsnate 
specification allows the user to specify a file 
name suitable for OS or DOS files such as SYS1. 
SYSLIB. NONAC for further file identification. 
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CLCLOSE 00143 Besponses 


CLCLOSE 00145 i£ aultiple copies of the file ace being processed, cr it 
CLCLOSE 00146 the file is being transferred to another user, the following 
CLCLOSE 00147 aessage appears: 

CLCLOSE 00152 (PHT) (TO userid] 

CLCLOSE 00153 { } spoolid { ) 

CLCLOSE 00154 (PUN) (COP* nn } 
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CLCOOPLE 


CLCOUPLE 


CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 


CLCOOPLE 


CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOOPLE 

CLCOUPLB 


0000* £22£LJE 

00007 Privi lege £!&§£*• G 


00008 

00009 

00010 

00011 


The COOPLE coaa and allows a user with a virtual 
(non-dedicated) channel-to-channel adapter tc connect that 
device to another user's (or his own, different) virtual 
channel-to-channel adapter. 


00020 ,-- 

00021 | COOPLE | vaddrl [TO] userid vaddr2 j 

Of>022 «---;-■» 


00028 

00029 

00030 


vaddrl specifies the virtual address (ecu) of the 
channel-to-channel adapter of the cser issuing the 
cobb and 


00033 TO 

00035 T 


is an optional reserved keyword. If this word 
is not specified, userid aay not be "TC M or "T". 


00037 userid 

00039 

00040 

00041 

00041 

00043 


is the user dent ification of the virtual nachine 
to which vaddrl is to be connected. If vaddrl is 
to be connected to the user issuing the CCUP1E 
coaaand, userid aay be specified as asterisk (*). 
The user Bust be logged on and have a virtual 
channel-to-channel adapter defined. 


00045 

00046 

00047 

00048 


vaddr2 specifies the virtual address (ecu) ct the 
channel-to-channel adapter to be ccnnected to 
vaddrl of the virtual aachine user isssuing the 
coaaand. 


00051 


Resp o nses 


00054 CTCA vaddrl COUPLE TO userid vaddr2 


*0057 


this is the response to the user issuing the COUELE coaaand 


00058 

*0059 

00060 

00062 


vaddrl is the address of the issuing users 
channel-to-channel adapter; userid is the identificaticn cf 
the receiving virtual aachine; and vaddr2 is the address of 
the channel-to-channel adapter of the receiving user. 


0C064 CTCA vaddr2 COUPLE BE userid vaddrl 


**065 

0**66 

*0067 

00068 


is the response to the user specified by userid in the 
COUPLE coaaand, vaddr2 is the address of the issuing user's 
channel-to-channel adaptor; userid is the identification cf 
the user who issued the COUPLE coaaand; and vaddrl is the 
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♦ 

CLCOOPLE fvijo69 address oi the chanaal-to-chaiiaei adaptor o t th« receiving 
CLDCP OOflOt usflt. 
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CLDCP 

00004 

CLDCP 

00007 


CLDCP 

00008 

CLDCP 

00010 

CLDCP 

00011 

CLDCP 

00012 

CLDCP 

00013 

CLDCP 

00014 

CLDCP 

00015 

CLDCP 

00026 

CLDCP 

00027 

CLDCP 

00028 

CLDCP 

00029 

CLDCP 

00030 

CLDCP 

00031 

CLDCP 

COO 32 

CLDCP 

00039 

CLDCP 

CC039 

CLDCP 

00040 

CLDCP 

00043 

CLDCP 

00043 

CLDCP 

00044 

CLDCP 

0 0045 

CLDCP 

00048 

CLDCP 

00 n 48 

CLDCP 

00049 

CLDCP 

00050 

CLDCP 

00051 

CLDCP 

"0052 

CLDCP 

0.00 55 

CLDCP 

00056 

CLDCP 

00058 

CLDCP 

00061 

CLDCP 

00062 

CLDCP 

00063 

CLDCP 

00064 

CLDCP 

00065 

CLDCP 

00066 


£££ 


Etililsas £iias: E 

The DCP coaaand allows a user to display the contents of 
real storage locations at the terainal. 

If an invalid arguaent is entered, the ECP coaaand 
terainates; however, any previous valid arguments are 
processed before teraination occurs. The operands for this 
coaaand aay be coabined in any order desired, separated by 
one or nore blanks. 


<r~- 

t DCP 

1 r i 

r tr r l 

1 1 1 

! 

| |L| [hexlocl] 

i i-i 1 ILJ 

hexloc2 | | | 

I 

1 1 T | 

I C) 1 1 T| 

! 1 1 

1 

1 

1 L J 

1 

1 1 L J 

L L 

ENfi III 

J J | 

_j 


L specifies that the contents of the specified 

storage locations are to be displayed in 

hexadeciaal. 

T specifies that, in addition to the hexadecimal 

display of the specified storage locations, an 
EBCDIC translation of the contents is tc be 
displayed. 


hexlocD specifies the first or only storage location to te 
displayed. If this field is not specified, L or 1 
aust be specified; the display till begin witii 
storage location 0. If hexloc is specified and L 
or T is not specified, the display will be the 
sane as if L were specified. 


hexloc2 


one of these delimiters oust be specified in a 
range specification. Either aay te surrounded by 
none, one, or aore blanks. 

specifies that a range , of, locations is to be 
displayed. Real storage locations from hexlccl 
through hexloc2 is displayed. If END is 
specified, real storage froa hexlccl through the 
end of real storage is displayed. If this field is 
not specified, END is assuaed by default. 


CLDCP 00070 Responses 
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CLDCP 00072 Requested locations are typed in the following fcrnat: 

CLDCP 00075 xxxxxx ~ wordl word2 word! word4 *EBCDIC translation* * 


CLDCP 00077 
CLDCP 00078 
CLDCP 00079 
CLDCP 00080 
CLDCP 00080 
CLDCP 00081 
CLDCP 00082 
CLDEFINE 00001 


where xxxxxx is the real storage location of wordl. Wcrdl is 
displayed (word aligned) for a single hexlcc specification. 
Op to 4 words are displayed on a line. If required, 
■ultiple lines are printed. The EBCDIC translation is 
displayed aligned to the next lower 16 b}te toundary if 
Thexloc is specified. The output can be stopped and tne 
conaand terminated by pressing the ATTN hey (or its 
equivalent) . 
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CLDEFINE 00004 DEFI NE 


CLDEFINE 00007 Privilege £lMS: G 


CLDEFINE 00009 The DBPIHE coaaand provides the user with the ability to 

CLDEFINE 00011 alter his virtual aachine configuration. The user can expand 

CLDEFINE 00012 his configuration without having to sake permanent changes, 

CLDEFINE 00013 since the definitions are in effect for the current terminal 

CLDEFINE 00014 session only. If storage is redefined, the virtual aachine 

CLDEFINE 00015 is reset and aust be re-IPLed. 

CLDEFINE 00026 ,- 

CLDEFINE 00027 J DEFINE ( { (READER } } i 

CLDEFINE 00028 J DBF | ( (PRINTER} J I 

CLDEFINE 00029 | | ( (PUNCH ) [AS] vaddr ) | 

CLDEFINE 00030 | | ( {CONSOLE} } | 

CLDEFINE 00031 | | ( (CTCA j } | 

CLDEFINE 00032 | | { (TIMER } } | 

CLDEFINE 00033 | I ( rill 

CLDEFINE 00034 | | { LINE £ AS ] vaddr lIBfJl I } I 

CLDEFINE 00035 | | ( |TEL£2| } | 

CLDEFINE 00036 | J ( t J } | 

CLDEFINE 00037 I I ( } I 

CLDEFINE 00038 | ! { vaddrl [AS] vaddr2 } ( 

CLDEFINE 00039 I I £ } i 

CLDEFINE 00040 J i ( {T2314} } j 

CLDEFINE 00041 J I ( (T2319) [AS] vaddr [CYL] nnr } | 

CLDEFINE 00042 | | { {T3330} } | 

CLDEFINE 00043 j | ( {T2305} } | 

CLDEFINE 00044 j J ( } I 

CLDEFINE 00045 j j { STORAGE [AS] nnnnnK } | 

CLDEFINE 00046 *-J 


CLDEFINE 

CLDEFINE 

00052 

00054 

AS 

A 

is an optional reserved keyword. 


CLDEPTNB 

CLDEFINE 

00056 

00058 

vaddr 

specifies the virtual address (ecu) to be assigned 
to the device being added. 

CLDEFINE 

CLDEFINE 

CLDEFINE 

00061 

00063 

00065 

READER 

R 

BDR 

specifies that a spooling card leader with the 
address specified by vaddr is to be added tc the 
virtual aachine configuration. 

CLDEFINE 

CLDEFINE 

CLDEFINE 

00067 

00069 

00071 

PRINTER 

P 

PRT 

specifies that a spooling printer 
specified by vaddr is to be added 
aachine configuration. 

kith the address 
to the virtual 

CLDEFINE 

CLDEFINE 

CLDEFINE 

00073 

00075 

00077 

PUNCH 

PU 

PCH 

specifies that a spooling card 
address specified by vaddr is tc 
virtual aachine configuration. 

punch with the 
be added to the 

CLDEFINE 

00079 

CONSOLE 

specifies that a virtual systea 

console is to be 
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DEFINE 

S 

( 

(READER 

} 



) 



DBF 

1 

c 

(PRINTER] 



i 




1 

£ 

(PU NCH 

} [AS] 

vaddr 


1 




I 

C 

(CONSOLE) 



} 




1 

( 

(CTCA 

1 



i 




1 

( 

(TIMER 

) 



} 




1 

( 



r 


} 




1 

( 

LINE 

[AS] 

vaddr IIBM1 

1 

) 




1 

£ 



| TELE2 | 

J 




\ 

( 



L 

j 

} 




1 

t 





} 




i 

£ 

vaddrl 

[AS] 

vaddr2 


} 





£ 





} 




1 

£ 

(T2314) 




} 





£ 

(T2319} 

[AS] 

vaddr [CYL] 

nnr 

} 




1 

( 

{T3330} 




} 




1 

C 

(T2 305} 




) 




1 

( 





) 




1 

£ 

STORAGE 

[AS] 

nnnnnK 


} 
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CLDEFINE 

00080 

CON 

CLDEFINE 

00081 


CLDEFINE 

00083 

CTCA 

CLDEFINE 

00084 


CLDEFINE 

00086 


CLDEFINE 

00089 

TIHEB 

CLDEPINE 

00091 

TIE 

CLDEFINE 

00092 


CLDEFINE 

00095 

LINE 

CLDEPINE 

00096 

LI 

CLDEFINE 

00098 


CLDEFINE 

00101 

IBH1 

CLDEFINE 

00103 

IBM 

CLDEFINE 

00106 

TELE2 

CLDEFINE 

00108 

TEL 

CLDEFINE 

"0111 

vaddr 1 

CLDEFINE 

00112 


CLDEFINE 

00113 


CLDEFINE 

00114 


CLDEFINE 

00115 


CLDEFINE 

00118 

T2314 

CLDEFINE 

00119 


CLDEPINE 

00119 


CLDEFINE 

00120 


CLDEFINE 

00121 


CLDEFINE 

00123 

T2319 

CLDEFINE 

00125 


CLDEFINE 

00125 


CLDEFINE 

00126 


CLDEFINE 

00127 


CLDEFINE 

00129 

T3330 

CLDEFINE 

"0131 


CLDEFINE 

00132 


CLDEFINE 

C0133 


CLDEFINE 

00134 


CLDEFINE 

00137 

T2305 

CLDEFINE 

00137 


CLDEFINE 

00138 


CLDEPINE 

00139 


CLDEFINE 

00140 


CLDEFINE 

00143 

CTL 

CLDEPINE 

00145 

nnn 


added to the virtual machine at the address 
specified by vaddr. 

specifies that a virtual channel-tc-cnannel 
adapter with the address specified ty vaddr is to 
be added to the virtual machine configuration. 

specifies that a pseudo timing device with the 
address specified by vaddr is tc le added to the 
virtual machine configuration. 

specifies that a virtual 270X communication line 
with the address specified by vaddr is tc be added 
to the virtual machine configuraticn. 

specifies that an IBM type of terminal (2741, 
1050, or equivalent) is on the 270X line. 

specifies that a teletypewriter is cn the 270X 
line. 

hS vaddr2 

specifies that the device represented by vaddr 1 is 
to be redefined as vaddr2. The first vaddr 
specified must be a defined device in the virtual 
machine configuration. 

specifies that a temporary virtual 2314 is to be 
added to the virtual machine configuration. The 
address of the 2314 is specified ty vaddr and the 
dish contains the number of cylinders specified by 
CTL nnn. 

specifies that a temporary virtual 2319 is tc be 
added to the virtual machine configuration. The 
address of the 2319 is specified ty vaddr and the 
disk contains the number of cylinders specified by 
CYL nnn. 

specifies that a temporary virtual 3330 is to be 
added to the virtual machine configuration. The 
address of the 3330 is specified ty vaddr ana the 
disk contains the number of cylinders specified by 
CTL nnn. 

specifies that a temporary virtual 23C5 is tc be 
added to the virtual machine configuration. The 
address of the 2305 is specified ty vaddr and the 
disk contains the number of cylinders specified ty 
CTL nnn. 

is an optional reserved keyword. 

specifies the number of cylinders the disk is to 
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CLDEFINE 

CLDEFINE 

CLDEFINE 

CLDEFINE 

CLDEFINE 

CLDEPINE 

CLDEFINE 

CLDEFINE 

CLDEFINE 

CLDEPINE 

CLDEFINE 

CLDEFINE 


CLDEFINE 


CLDEFINE 

CLDEFINE 

CLDEFINE 

CLDEFINE 

CLDEFINE 

CLDEFINE 

CLDEFINE 

CLDEPINE 

CLDEFINE 

CLDEFINE 

CLDEFINE 

CLDEFINE 

CLDEPINE 

CLDEFINE 

CLDEFINE 


00146 


contain. 

00149 

STORAGE 

specifies that the size of the virtual storage for 

00151 

00152 

00152 

00153 

00154 

00154 

00155 

00156 

STOfi 

the virtual aachine is to be redefined. The value 
specified trill becoae the new virtual sfcrage 
size. Sizes aust be in 4K increaents and are 
liaited by the aaziaua value» in the user directory 
entry. Changing the virtual storage size 
(increasing or decreasing) causes a virtual systea 
reset and the clearing of £ll virtual storage to 
binary zeros. 

00158 

00160 

nnnnnK 

specifies the new size of the aachine ( e virtual 
storage, where K represents 1024 bytes. 


00163 

Responses 



00164 

Responses 

are generated for the user 

to ccnfiri that the 

00166 

desired configuration change has taken 

place. 

00168 

type vaddr 

: DEFINED 


00170 

STORAGE - 

nnnnnK 


00174 

In the first response, ‘type* is one of 

the following: 

00177 

DASD 

Direct access storage device 


00178 

TAPE 

Magnetic tape 


00179 

LINE 

Coanunication line 


00180 

RDB 

Card reader 


00181 

PRT 

Line printer 


00182 

PUN 

Card punch 


00183 

GRAF 

Graphics device 


00184 

COM3 

Console 


C0185 

CTCA 

Channel-to-channel adapter 


00186 

DEV 

Any other device 
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CLDETACH 00004 J£E1A£B 

CLDETACH 00007 Priv i lege Ci^ss: B, G 


CLDETACH 00009 The DETACH command is used to remove a virtual device frcm 
CLDETACH 00010 the virtual machine or to remove a real device frcm the CP 
CLDETACH 00011 system. A previously attached device can be detached troa a 
CLDETACH 00013 user even if the device is currently in use. The user may 
CLDETACH 00014 also detach devices that were attached via user directory 
CLDETACH 00016 entries or from CP system initialization. Cevices attached 
CLDETACH 00017 to the system and currently in use for spooling, paging, cr 
CLDETACH 00018 users minidisks cannot be detached. When the user detaches 
CLDETACH 00019 a virtual device, it becomes inaccessible tc the virtual 
CLDETACH 00020 machine. If the device had previously been attached to the 
CLDETACH 00021 user by an ATTACH command, it is released and becomes 
CLDETACH 00021 available for attachment to the sane user, another user, or 
CLDETACH 00022 the CP system. Tape devices are automatically rewound and 
CLDETACH 00023 unloaded when detached. For devices that were attached by 
CLDETACH 00024 an ATTACH command and then detached by the user, a message 
CLDETACH 00025 is sent to the operator informing him that the device is 
CLDETACH *0026 free. 


CLDETACH 00037 
CLDETACH 00038 
CLDETACH 00039 
CLDETACH 00040 
CLDETACH 00041 


CLASS B 


CLASS G 


| DETACH | {userid} | 

I DET |raddr [FBOM ] {SYSTEM} | 


|DETACH | vaddr 
| DET | 



CLDETACH 00047 raddr is the real address (ecu) of the device tc be 
CLDETACH 00C48 detached. Only class B users may cse this fora cf 
CLDETACH 00049 the command. 

0 

CLDETACH 00052 FROM is an optional reserved keyword. If this word is 
CLDETACH 00053 F omitted and userid is specified, userid may not be 
CLDETACH 00055 FROM or any of its truncations, 

CLDETACH 00^57 userid specifies the user identification cf the virtual 
CLDETACH 00058 machine to which the real device (raddr) is 
CLDETACH 00059 currently attached. 

CLDETACH 00062 SYSTEM indicates that the device is a EASD device in use 
CLDETACH 00063 by CP for allocation and control. 

CLDETACH ^0065 vaddr specifies the virtual address (ecu) ci the device 
CLDETACH 00^67 to be detached from the virtual machine. 


CLDETACH 00071 Resp o nses 

CLDETACH 00073 Messages are sent to the user, the operator whe issued the 
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CLDETACH 00075 
CLDETACH 00076 
CLDETACH 00077 


coaaand* and the priaary systea operator (it different froa 
the operator who issued the coaaand ), notifying then that 
the DETACH was successful. 


CLDETACH 00080 


type vaddr DETACHED 


CLDETACH 00081 
CLDETACH 00082 


is the response to the user when he detaches one of his own 
devices. 


CLDETACH 00085 


type vaddr DETACHED BY operator 


CLDETACH 00086 
CLDETACH 00087 


is the response to the user if an operator detaches one cf 
his devices. 


CLDETACH 00094 
CLDETACH 00096 
CLDETACH 00097 
CLDETACH 00098 
CLDETACH 00100 
CLDETACH 00101 
CLDETACH 00102 


r i 

type raddr DETACHED JuseridJ 

|SYSTEM| 

L j 

is the response to the operator if the tser detaches a 
previously attached device or if the operator detaches it 
froa a user or the systea. 


CLDETACH 00104 
CLDETACH *0106 
CLDETACH 00107 
CLDETACH 00108 
CLDETACH 00110 
CLDETACH 00110 
CLDETACH 00111 


r ■» 

type raddr DETACHED |userid) BY operator 
|SYSTEM J 
L J 

is the response to the priaary systea operator if be did net 
issue the DETACH coaaand and the device had been previously 
attached. 


CLDETACH 00116 


In the above responses, 'type* is one of the following: 


CLDETACH 00119 DASD 

CLDETACH C0121 TAPE 

CLDETACH 00123 LINE 

CLDETACH 00125 RDB 

CLDETACH 00127 PRT 

CLDETACH 00129 PUN 

CLDETACH 00131 GRAF 

CLDETACH 00133 CONS 

CLDETACH 00135 CTCA 

CLDETACH 00137 DEV 


Direct access storage device 

Magnetic tape 

Coaaunication line 

Card reader 

Line printer 

Card punch 

Graphics device 

Con sole 

Channel-to-channel adapter 
Any other device 


0 
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CLDETCHN 00003 SflMUJBlf 


cldetchn 00006 fEiiilsas B 


CLDETCHN 00007 The DETACH CHANNEL coaaand detaches a previously dedicated 
CLDETCHN 00008 channel froa a user. The virtual aachine nust have all I/O 
CLDETCHN 00009 stopped before the function is invoked. 

CLDETCHN 00018 
CLDETCHN 00C19 
CLDETCHN 00020 
CLDETCHN 00021 

CLDETCHN 00027 CHANNEL is a required reserved keyword. 

CLDETCHN 00029 c is the real address of the channel which is to be 
CLDETCHN 00030 detached. 

CLDETCHN 00034 FROM is an optional reserved keyword. If this word is 
CLDETCHN 00037 F oaitted, userid nay not be FRCM or any of its 
CLDETCHN 00038 truncations. 

CLDETCHN 00041 userid specifies the user identification c£ the virtual 
CLDETCHN 00043 aachine froa whoa the channel is tc be detached. 


CLDETCHN 00048 Resp onses 


CLDETCHN 00050 CHANNEL c DETACHED BE operator 

CLDETCHN 00052 is sent to the user froa whose virtual aachine the channel 
CLDETCHN 00053 is being detached. 


CLDETCHN 00055 CHANNEL c DETACHED userid 

CLDETCHN 00057 is sent to the operator issuing the coaaand. 


CLDETCHN 00059 CHANNEL c DETACHED userid BE operator 

CLDETCHN 00061 is sent to the priaary systea operator if he did not issue 

CLDI4L "9001 the coaaand. 


| DETACH | CHANNEL c [FROM] userid | 
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CLDIAL 00003 


CLDI&L 00006 ftiiilgag £!&§§: ALL 


CLDIAL 00007 
CLDIAL 00*09 
CLDIAL C0C10 
CLDIAL *0*11 
CLDIAL 00*12 
CLDIAL 90*13 
CLDIAL 00014 
CLDIAL 00015 
CLDIAL *0*17 
CLDIAL 99019 
CLDIAL 00020 
CLDIAL 00021 
CLDIAL 00922 


The DIAL coaaand is used to connect a user's terninal tc a 
mlti-access virtual aachine. The systea being dialed into 
oust be logged in with virtual communication lines available 
and enabled before a connection can be made. The CP system 
Batches the terminal type with an equivalent virtual line. 
Once a connection is aade, the terninal is under exclusive 
control of the virtual aachine it is dialed into. It 
reaains this way until the virtual aachine issues a D1SAELE 
coaaand to the line, detaches the lire, or logs cut; then 
the user is free to Login to VM/370 or dial another user. 
Refer to the liria&j. £l£AAiAJ2JZ£* lerfiifiaj, 
User * s Gui da (Order No. GC20-1810) for a description cf 
multi-access virtual machines. 


CLDIAL 

CLDIAL 

CLDIAL 

CLDIAL 


99*46 

00*47 

09048 

00949 


CLDIAL 

CLDIAL 

CLDIAL 

90032 

00933 

09C34 

i — 

| DIAL 

1 D 
• 

-8 

| userid [vaddr] | 

1 t 





CLDIAL 

CLDIAL 

90940 

99*42 

userid 

specifies the userid of a aulti-access 
aachine currently logged in. 

vir 

CLDIAL 

CLDIAL 

00*44 

90945 

vaddr 

specifies the address (ecu) of the 

communication line to which the tersiral 

vir 
is t 


connected. If not specified, CP will natch the 
user's terainal type to the first available 
coanunication line of similar type defined for the 
virtual aachine. 


CLDIAL 00052 
CLDIAL 00052 
CLDIAL 90953 
CLDIAL 90954 


Note; The DIAL coaaand is only accepted as an alternate to 
the LOGIN coaaand. It cannot be used cnce a user has issued 
a CP LOGIN coaaand. The user Bust issue a LCGCUI coaaand 
after logging in to issue the DIAL ccoaand. 


CLDIAL 

00056 

Responses 


CLDIAL 

0*958 

DIALED TO userid vaddr 


CLDIAL 

CLDIAL 

09059 

09*60 

is the aessage sent to the user indicating that 
has been aade. 

a ccnnecticn 

CLDIAL 

90062 

LINE raddr DIALED TO userid DIALED = non 


CLDIAL 

0*064 

is the response to the primary systea operator. 

It indicates 
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CLDIAL 

CLDIAL 

CIDIAL 

00065 

00065 

00067 

a successful connection to the virtual machine (userid) and 
the total nuaber of VH/370 lines (nnn) currently connected 
to other virtual aachines. 

CLDIAL 

CLDIAL 

CLDIAL 

CLDIAL 

00069 

00070 

00071 

00072 

Note: The terainal will reaain connected tc and under 
control of the victual aachine dialed to until that virtual 
aachine terainates the coaaunication. At that tine the user 
will receive the following aessage: 

CLDIAL 

00074 

DROP FROM userid vaddr 

CLDIAL 

CLDIAL 

00075 

00076 

this aessage will be sent to the user when the line is 
disabled. 

CLDIAL 

00078 

LINE raddr DROP FROM userid DIALED s nnn 

CLDISABL 

00001 

is the aessage sent to the Primary Systea Operator 
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CLDISABL 00003 EISAfiJtE 

CLDISABL 00006 Priv i lege £Aa§§: A,B 


CLDISABL 00C07 
CLDISABL 00009 
CLDISABL 00009 
CLDISABL 0^010 
CLDISABL 00011 
CLDISABL 00012 
CLDISABL 00013 
CLDISABL 00014 
CLDISABL 00015 


The DISABLE coaaand is used tc prevent low-speed 
co*aunication lines froa accessing the VM/37C systea. If the 
line or lines selected are not active (not dialed cr legged 
in ), the line is disabled iaaediately. If the selected line 
is active, it is disabled when the user has ccapleted his 
terainal session and does a LOGOUT. An ENABLE couand issued 
to the line before the line is physically disabled 
reinstates the enabled status, thus negating the DISABLE 
connand. 


CLDISABL 00024 
CLDISABL 00025 
CLDISABL 00026 
CLDISABL 00027 


I DISABLE | (raddr... ) 
| DISA | (ALL ) 


i 


I 

I 

j 


CLDISABL 

00034 

raddr 

specifies 

CLDISABL 

00035 


lines the 

CLDISABL 

00037 

ALL 

specifies 

CLDISABL 

00038 


disabled. 


the addresses (ecu) cf ary coiarnicaticn 
operator wishes to disable. 

that all coaaunication lines are to be 


CLDISABL 000*1 


BSSE2MS 


CLDISCQN 00001 


COHNAND COMPLETE 
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CLDISCON 00004 BISS2M 


CLDISCON 00007 Privi lege £la§§: ALL 


CLDISCON 00009 The DISCONN command disconnects the user's terminal from the 
CLDISCON 00010 VM/370 system, but allows the virtual machine tc continue 
CLDISCON 00011 operation. When DISCONN is issued from the virtual machine, 
CLDISCON 00012 a disconnect-time message is printed at the user's terminal 
CLDISCON 00013 and at the primary system operator's console, the terminal 
CLDISCON 00014 remains disconnected until the user reconnects via a LOGIN 
CLDISCON 00016 command. The virtual machine is logged out if an attempt is 
CLDISCON 00016 made to read from the terminal or it the virtual machine 
CLDISCON 00017 goes into a disabled wait state. During the disconnect 
CLDISCON 00018 time, no messages to the virtual console are saved. When 
CLDISCON 00019 the user reconnects via the normal LOGIN procedure, the 
CLDISCON 00021 terminal is placed in CP console function mede. To resume 
CLDISCON 00021 execution of the virtual machine, the terminal user must 
CLDISCON 00023 enter the BEGIN command. 

CLDISCON 00032 
CLDISCON 00033 
CLDISCON 00034 
CLDISCON 00035 

CLDISCON 00042 HOLD specifies that the communication line is not to te 
CLDISCON 00044 HO disabled. This option is effective fer switched 
CLDISCON 00045 lines only. If specified, contrcl will return to 
CLDISCON 00046 CP and the "VM/370 online” message will type. 


CLDISCON 00049 Responses 


CLDISCON 00050 The user receives a DISCONNECT time message when the command 
CLDISCON 00052 is issued. 


CLDISCON 00054 DISCONNECT AT hh:mm:ss zone weekday mm/dd/yy 

CLDISCON 00056 is the response to the user who issued the ccmmand. 


CLDISCON 09*58 LINE raddr DSCONNECT userid USERS = nun 

CLDISCON 00060 is the response to the primary system operatcr informing him 
CLDISCON 00060 that the user respresented by “userid” has been disconnected 
CLDISCON 00061 from the VH/370 system. ”nnn” is the number cf users 
CLDISCON 00063 remaining in the system. 


| DISCONN J [HOLD] j 
| DISC S i 
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CLDISPLA 00004 


CLDISPLA 00007 Privile ge Class: G 


CLDISPLA 00009 The DISPLAY command Bakes available to the user the contents 

CLDISPLA 00009 of selected components of his virtual machine. He aay 

CLDISPLA 00011 display the contents of: 

CLDISPLA 00015 • virtual storage locations 

CLDTSPLA n C017 • general registers 

CLDISPLA 00C19 • floating-point registers 

CLDTSPLA 0DD21 • extended control registers 

CLDISPLA 00023 ® prcgraa status word (PSW) 

CLDISPLA ^0025 • channel address word (CAN) 

CLDISPLA 00027 • channel status word (CSH) 

CLDISPLA 00031 If an invalid argument is entered, the DISPLAY coaaand 

CLDISPLA 09031 terminates; however, any previous valid augments are 

CLDISPLA 09033 processed before termination occurs. Ihe operands for this 

CLDISPLA 9Q034 coonand aay be combined in any oraer desired, separated ty 

CLDISPLA 00015 one or more olanks. 


CLDISPLA 

CLDISPLA 

00046 

C0C47 

r~ 

1 



(r i 

) 

r rr i 1 

i 1 

CLDISPLA 

99048 

J 

DISPLAY 

1 

11 L| 

) 

1 f”) 1 1L | | 

I i 

CLDISPLA 

0 0049 

! 

D 

1 

(| T|[hexloc1 1} 

| (: } | | T | hex loc2 | 

1 1 

CLDISPLA 

09050 

1 


1 

(I K| 

) 

L 1 J 1 

j | 

CLDISPLA 

00051 

1 


1 

C L J 

} 

1 M£ 1 


CLDISPLA 

00052 

1 





L J 


CLDISPLA 

00055 

1 


1 

r i 

r 

■ 1 


CLDISPLA 

00°56 

1 


1 

|G| 

1 ("J 

1 


CLDISPLA 

99057 

1 


1 

<Y> regl 

1 Cl 

reg2 | 


CLDISPLA 

09058 

1 



1 X| 

1 

1 


CLDISPLA 

00059 

1 



L J 

1 

j 


CLDISPLA 

00060 

i 


1 





CLDISPLA 

00061 

1 


1 

(psw) 




CLDISPLA 

09062 



1 

(CAN) 




CLDISPLA 

00063 

1 


1 

(CSN) 




CLDIS PLA 

9 0064 

L- 






_____ j 

CLDISPLA 

09071 

L 


specifies 

that 

the contents of 

the 


CLDISPLA 00071 storage locations are tc be displayed in 

CLDISPLA 00072 hexadecimal, 

CLDISPLA 00075 T specifies that, in addition to the hexadecimal 
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CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 
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00C75 

00076 

00077 


display of the specified storage locations, an 
EBCDIC translation of the contents is tc be 
displayed. 


00080 K " specifies that the storage key of the specified 

00081 storage locations is to be displayed. 


00084 

00084 

00085 

^0086 

00086 

0D088 


hexlocl specifies the first or only storage location to be 
displayed. If this field is not specified; L, T, 
or K sust be specified; the display will begin at 
storage location 0. If hexlocl is specified and 
L, K, or T is not specified, the display will ne 
the same as if L were specified. 


"0092 

00096 

00098 


are delimiters used to indicate range 
specifications. Either delimiter nay be 
surrounded by none, one, or more blanks. 


00102 

00106 

00107 

00107 

00108 

00109 

00110 

00110 

00111 


hexloc2 specifies that a range of storage locations from 
hexlocl to and including hexlcc2 are to fce 
displayed. If END is specified, all storage 

locations from hexlocl to the end of virtual 

storage are displayed. If Lhexlocl is specified, 
Lhexloc2 may be used; if Thexlocl is specified, 
Thexloc2 may be used. however, the first argument 
determines the display format so the L or T 

preceding hexloc2 is not necessary. 


09114 G 
09114 
00115 
00116 
00116 
00118 


specifies that general registers are tc be 
displayed, where regl, if specified, is specified 
as a decimal number from 0-15 ox a hexadecimal 
digit from 0-F. If register is not specified 
(that is, DISPLAY G is specified), all cf the 
user’s general registers are displayed. 


00121 Y 
00121 
00122 
00123 
00124 
00126 


specifies that floating-point registers are to fce 
displayed where regl is a number frco C-6. It 
regl is odd, it is adjusted to the preceding even 
number. If regl is not specified, (that is, 
DISPLAY Y is specified), all of the user's 
floating-point registers are displayed. 


00129 X 

00129 

99139 

09130 

0O131 

03132 

00133 

00134 


specifies that the extended ccntrcl registers are 
to be displayed, where regl, if specified, is 
either a decimal number from 0-15 cr a hexadecimal 
digit from 0-P. If regl is not specified, (that 
i3, DISPLAY X is specified) all of the user's 
control registers are displayed. If the user does 
not have extended mode operations availafcle, only 
control register 0 is displayed. 


00136 regl specifies the first or only xegister tc fce 

00137 displayed. 
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CLOISPLA 

00139 

CLDISPLA 

00140 

CLDISPLA 

"0141 

CLDISPLA 

00144 

CLDISPLA 

00145 

CLDISPLA 

00149 

CLDISPLA 

"0150 

CLDISPLA 

00153 

CLDISPLA 

00153 

CLDISPLA 

00154 


CLDISPLA 

00157 

CLDISPLA 

00159 

CLDISPLA 

00160 

CLDISPLA 

"0162 

CLDISPLA 

00165 

CLDISPLA 

"0167 

CLDISPLA 

"0167 

CLDISPLA 

"0168 

CLDISPLA 

00169 

CLDISPLA 

00171 

CLDISPLA 

00172 

CLDISPLA 

00173 

CLDISPLA 

00174 

CLDISPLA 

"0175 


CLDISPLA 00178 
CLDISPLA 00180 


CLDISPLA 

00183 

CLDISPLA 

00185 

CLDISPLA 

00186 

CLDISPLA 

00187 

CLDISPLA 

00188 

CLDISPLA 

00189 


reg2 specifies that a range of . registers is to he 

displayed beginning with regl and ending with 
reg2. 

PSW displays the current virtual machine PSW (program 

p status word) as two hexadecimal words. 

CAW displays as one hexadecimal word the contents of 

hexadecimal location 48 (channel acdress word). 

CSW displays as two hexadecimal words the contents or 

the channel status word (doubleword at hexadecimal 
location 40). 


Resp o nses 


One or more of the following responses is typed, depending 
upon the operands specified. 

LOCATIONS: 


xxxxxx = word 1 word2 world word4 ^EBCDIC TRANSLATION* 


Where xxxxxx is the storage location of 
displayed (word-aligned) for a 
specification. Up to 4 words are disp 
followed, optionally, by an EBCDIC tran 
4 words. Multiple lines are used if 
range of locations. If translation 
requested (Thexloc), alignment is ma 
lower sixteen-byte boundary; otherwi 
made to the next lower fullword boundar 


woral. Wordl is 
tingle hexlcc 
layed on a line 
slaticn of these 
required for a 
to EBCDIC is 
de tc the next 
se alignment is 


RETS: 

XXXXXX TO XXXXXX KEY - XX 


GHEGs 

GPR 0 = regO regl reg2 cag3 

Up to 4 registers per line are displayed for a range of 
registers* Multiple lines are printed if required, with 
a maximum of four lines needed to display all sixteen 
general registers. 


286 



IBM CONFIDENTIAL 


CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 


CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 


CLDISPLA 

CLDISPLA 

CLDISPLA 


CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 


CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDISPLA 

CLDMCP 


00193 

YREGS: 


00195 


FPE 0 2 XXXXXXXXXXXXXXXX .XXXXXXXXXXXXIXXXX E XX 


00198 

00199 

00200 

00203 


The contents of the requested floating-point registers 
are displayed in both the internal hexadecimal foraat 
and the E foraat. One register per line is typed. 
Multiple lines are typed for ‘a range of registers. 

00206 

XBEGS: 


00208 


ECH 0 * regO regl reg2 reg3 


00209 

00210 

00212 


The contents of the requested extended ccnticl register 
are typed in hexadeciaal. Up to 4 regiscrs per line are 
typed. Multiple lines are typed if required. 

00215 

PSW: 



00217 


PSW 2 xxxxxxxx xxxxxxxx 


00219 


The contents of the PSW are typed in hexadecimal. 


00222 

CAW: 



00224 


CAM 2 xxxxxxxx 


00225 

00226 


The contents of the CAW (location 48) are typed 
hexadeciaal. 

in 

00229 

CSW: 



00231 


CSW 2 xxxxxxxx xxxxxxxx 


00232 

00233 


The contents of the CSW (location 40) are typed 
hexadeciaal. 

in 

00236 

00237 

00001 

To terminate this function while data is typing at the 
terminal, the ATTN key (or its equivalent) nay te pressed. 
Typing terainates and another coanand nay be entered. 
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CLDMCP 


CLDMCP 


CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 

CLDMCP 


00003 DMCP 


00006 ££ivilsae Class: E 


00C08 The DMCP command prints the contents cl real storage 
00010 locations on the user's virtual spooled printer. The output 
00011 format is eight words per line with EBCDIC translaticn. It 
00012 a descriptive header line (dunpid) is desired as the rirst 
00"14 line of dump output, the user aay enter as aany characters 
00015 as will fit on the reaainder of the input line. Tc get the 
00017 output printed on the real printer, the virtual spooled 
00018 printer aust be terminated with a CLOSE command. 


00029 
00030 
00031 
00032 
00033 
00034 
"00 35 
00036 


I DHCP J 
I I r i 

| | | L|[hexlocl] 

I I m 

I I *■ J 

I i 


r r r i i i 

| | |L|hexloc2| | 

I {-) I |T| || 

J {:> I L J It 

t I END II 

L L J j 


I 

[dumpid ] I 




00044 L 

00048 T 

00048 

00049 

00050 

"0051 

00052 


either of these constants aay be specified 
preceding hexlocl or he*xloc2 in which case they 
have no meaning. If either is specified in the 
first arguaent and hexlocl is not specified 
dumping will begin at storage locaticn 3. They 
aay not be specified following the delimiter if 
hexloc2 is not specified. 


00054 
00055 
0 0056 


hexlocl specifies the first or ouly storage iccaticn to te 
dumped. If this field is not specified, L ct 1 
aust be specified. 


00059 

00061 

00062 


either of these delimiters may be csed to indicate 
a range of addresses to be dumped. The delimiter 
may be surrounded by none, one, or more blanks. 


00065 

00067 

00068 

00C69 


hexloc2 

£RD 


indicates a range of real storage lccaticns to te 
dumped. To dump to the end cf real storage, 
hexloc2 may be specified as END or net specified 
at all, in which case END is assumed by default. 


00071 duapid 

00072 

00073 

00074 

00075 

00075 

00076 


is specified for identification purposes. If text 
is entered, it becomes the first line printed cn 
the output. As aany characters as will fit on the 
input line aay be specified. If duapid is 
specified, hexloc2 aay not be emitted if the 
contents of a range of '’addresses are tc be 
printed* 
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CLDRA IN 00004 DRAI N 

CLDRAIN 00007 fiEililsae Clag§: 0 


CLDRAIN 00009 
CLDRAIN 00010 
CLDRAIN 00011 
CLDRAIN 00C12 
CLDRAIN 00013 
CLDRAIN 00014 
CLDRAIN 00C15 
CLDRAIN 00^16 
CLDRAIN 00016 
CLDRAIN 00017 


The DRAIN coaaand stops spooling operations cn the specified 
real unit record devices after the file currently being 
processed has coapleted. This coaaand is used ty the 
spooling operator to bring the spooling systea cr a 
specified device to a controlled halt, cr to halt the 
activities on a device whose spooling status is to he 
changed. For exaaple, all unit record devices are usually 
drained before systea shutdown, and a printer aust he 
drained before the contents of the UCS printer buffer are 
changed. 


CLDRAIN 00019 
CLDRAIN 00020 
CLDRAIN 00021 
CLDRAIN 00022 
CLDRAIN 00022 
CLDRAIN C0024 


A device is drained iaaediately if it is not active when the 
DRAIN coaaand is issued; otherwise, it is drained when 
processing of the current file has coapleted. A drained 
device can be restarted by the START coaaand. If START is 
issued to a device before draining is coaplete, the device 
does not enter the drained status but continues processing. 


CLDRAIN 

OO033 

y— 

— 



—S 

CLDRAIN 

00034 

1 

i 

r 

1 

1 

CLDRAIN 

•0 0 r 35 

| DRAIN 

1 

|READER 

1 

1 

CLDRAIN 

00^36 

| DR 

1 

)PRINTER 

1 

1 

CLDRAIN 

00037 

1 

« 

| PUNCH 

1 

1 

CLDRAIN 

00038 

1 

1 

j raddr... 


i 

CLDRAIN 

00039 

1 

1 

l&LJt 

1 

1 

CLDRAIN 

CLDRAIN 

00040 

nrntit 

1 

i- 

1 

L 

J 

1 

—J 


CLDRAIN OOP47 
CLDRAIN 00049 
CLDRAIN 00051 


READER specifies the type of device to be drained, 
R 

RDR 


CLDRAIN 00053 
CLDRAIN 00055 
CLDRAIN 00057 


PRINTER 

P 

PRT 


CLDRAIN 00059 PUNCH 

CLDRAIN 00061 PU 

CLDRAIN 00063 PCH 


CLDRAIN 00065 
CLDRAIN 00067 
CLDRAIN 00068 


raddr specifies the addresses (ecu) of real spooled 
devices that are to be drained. Multiple addresses 
say be specified. 


CLDRAIN 00071 ALL 
CLDRAIN 00073 


All spooled unit record devices in the systea are 
to be drained. 
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CLDBAIN 

00077 

Responses 






CLDRAIN 

00081 

type 

raddr SPOOL CLS [ a.. . ] 

DRAINED 




CLDRAIN 

00083 

This 

response is 

given for 

each device 

i which enters 

the 

CLDRAIN 

00084 

drained status; 






CLDRAIN 

00087 

type 

- one of the 

following: 





CLDRAIN 

00090 


RDR 






CLDRAIN 

00092 


PRT 






CLDRAIN 

00094 


PON 






CLDRAIN 

00098 

a - 

identifies 

the output classes 

which the 

drained 

CLDRAIN 

00099 


device was 

servicing. 

This field 

does net 

print 

f CE 

CLDRAIN 

00100 


RDR devices 

• Fron one 

to four classes will 

print 

for 

CLDRAIN 

00101 


PRT or PON 

devices. 
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CLDOflP 

00003 

CLDOHP 

00006 


CLDOHP 

00008 

CLDOHP 

00008 

CLDOHP 

00010 

CLDOHP 

0 00 14 

CLDOHP 

00016 

CLDOHP 

O0018 

CLDOHP 

00020 

CLDOHP 

00022 

CLDOHP 

000 24 

CLDOHP 

0 0026 

CLDOHP 

00027 

CLDOHP 

00028 

CLDOHP 

00030 

CLDOHP 

00032 

CLDOHP 

00033 

CLDOHP 

00034 

CLDOHP 

00035 

CLDOHP 

00036 

CLDOHP 

00037 

CLDOHP 

00038 

CLDOHP 

00O40 

CLDOHP 

00041 

CLDOHP 

00052 

CLDOHP 

00053 

CLDUHP 

00054 

CLDOHP 

00055 

CLDOHP 

C0056 

CLDOHP 

00057 

CLDOHP 

00058 

CLDOHP 

00059 

CLDOHP 

00065 

CLDOHP 

00069 

CLDOHP 

00069 

CLDOHP 

00070 

CLDOHP 

00071 

CLDOHP 

00072 

CLDOHP 

00073 


J 2 J 20 E 

fiEilllaflg Class: CJ 


The DUMP command causes the contents of various components 
of the virtual machine to be printed on the virtual spooled 
printer. The user aay print the contents of the following: 

• virtual program status word (PSW) 

• general registers 

• floating-point registers 

«• extended control registers (optional) 

® storage keys 

• virtual storage locations 

The DUMP command prints the virtual PSW and the virtual 
registers (general, floating-point, and control). If only 
this inforaation is desired, at least one virtual address 
aust be specified, such as: 

DOHP 0 


The output format for the virtual storage locations is 8 
words per line with EBCDIC translation on the right. Each 
fullword consists of 8 hexadeciaal characters. All the rest 
of the inforaation (PSW, general registers, etc.) is printed 
in hexadecimal. If the virtual machine is in virtual EC 
(extended control) node, the control registers are also 
printed. To print the duap on the real piinter, a CLOSE 
aust be issued to the spooled virtual printer. 


DHCP | 

I r i 

| |L|{hexloc1 ] 
I |T| 

| t j 

I 


r r r i it 

1 | |L|hexldc2| I 

I {-} I IT| II [duapid] 

I (:) I *■ J II 

I I END II 

L L J J 


L either of these constants aay be specified 

T preceding hexlocl or hexloc2 in which case they 

have no meaning. If either is specified in the 
first argument and hexlocl is not specified 
dumping will begin at storage location 0. They 
aay not be specified following the delimiter if 
hexloc2 is not specified. 
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CLDUHP 

CLDOMP 

CLDOSP 

CLDOMP 

CLDOMP 

CLDOMP 

CLDOMP 

CLDOMP 

CLDOMP 

CLDOMP 

CLDOMP 

CLDOMP 

CLDOMP 

CLDOMP 

CLDOMP 

CLDOMP 

CLDOMP 

CLDOMP 


CLDOMP 


CLECHO 


00075 hexlocl 

00076 

00077 


specifies the first or only storage location to be 
dumped. If this field is not specified, L or T 
must be specified. 


00080 

00082 

00082 

00083 


either of these delimiters may be used tc specify 
that a range of addresses is to fce dumped. The 
delimiters may be surrounded by none, one, or more 
blanks. 


00086 

00088 

00089 

00090 


hexloc2 indicates that a range of addresses is to be 

BMP printed. To dump to the end of virtual storage, 

hexloc2 may be specified as END oc not specified 
at all, in vhich case END is assumed by default. 


00093 dampid 

00094 

00095 

00097 

00098 

00098 

00099 


may be entered for descriptive purposes. If 
specified, if becomes the first line printed on 
the dump. As many characters as till fit on the 
D0MP command input line may be specified. If 
dumpid is specified, hexloc2 nay net be emitted if 
the contents of a range of addresses are to be 
printed. 


00102 Begpo nse 


00001 COMMAND COMPLETE 
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CLECHO 

00003 

CLBCHO 

00006 


CLECHO 

00008 

CLECHO 

00008 

CLECHO 

00009 

CLECHO 

00011 

CLECHO 

0001 1 

CLECHO 

00012 

CLECHO 

00C13 

CLECHO 

00014 

CLBCHO 

00015 

CLECHO 

00015 

CLECHO 

00016 

CLECHO 

00017 

CLECHO 

00024 

CLECHO 

00025 

CLECHO 

00026 

CLECHO 

00027 

CLECHO 

00028 

CLECHO 

00029 

CLECHO 

00034 

CLECHO 

00035 

CLECHO 

00036 

CLECHO 

00037 


CLECHO 

00040 

CLECHO 

00C42 

CLECHO 

CLECHO 

00044 

00045 

CLECHO 

00047 

CLECHO 

CLECHO 

CLECHO 

CLENABLE 

00049 

00049 

00050 

00001 




££ililS£e Ci^as: S 


The ECHO command places the user's terminal in the ECHO 
environment. When a user is intthe ECHO environment, any 
input line he enters is transmitted unchanged lack to his 
terminal a specified number of tines. Should the user wish 
to terminate this transmission to enter a different data 
line, he must press the ATTN key (or its equivalent). When 
the specified number of lines has been typed cr the 
Attention key has been hit, another read to the terminal is 
issued to accept another data line. Note that nc 
line-editing is done; thus, the output line is the same as 
the input line and nay contain any of tie logical line 
editing characters. 


I 
I 
I 
I 

.i 

nn Specifies the number of times the line is to le 

sent. The default is 1. An invalid entry (that 
is, one that is greater than 99 cr contains 
non-numeric characters) is treated as 1. 


Responses 


ECHO ENTERED? TO TERMINATE TEST, TYPE END 

This message is printed after the ECHO command is invoked to 
inform the user that he is in the ECHO environment. 


ENTER LINE 

This message is typed to indicate that the user shcrld enter 
a line to be transmitted back to his terminal. If he 
replies "END", his terminal returns to the CP console 
function mode. 


I I r ■» 

| ECHO | 1 nn j 

i ec i m I 

t i *■ J 

I_ 
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CLENABLE 00003 ££A£L£ 


CLBNABLB 00006 £l§ss: A,B 


CLENABLE 00007 The ENABLE coaaand allows the operator to enable previously 

CLENABLE 00009 disabled or non-enabled coaaunication lines sc users aay 

CLENABLE 00010 access the VM/370 systea. Previously enabled lines are not 
CLENABLE 00011 affected by this coaaand. This command affects cnly low 

CLENABLE 00012 speed coaaunication lines (not greater than 600 bps (bits 
CLENABLE 00013 per second)). 

CLENABLE 00022 ,- 

CLENABLE 00023 | ENABLE | (raddr...) J 

CLENABLE 00024 | EN | (ALL } | 

CLENABLE 00025 »-» 

CLENABLE 00031 raddr specifies the addresses (ecu) of the lines that 

CLENABLE 00032 are to be enabled. If note that ere raddr is 

CLENABLE 00033 specified, each aust be separated free the others 

CLENABLE 00034 by one or aore blanks. 

CLENABLE 00037 ALL specifies that all previously disabled cr 

CLBNABLB 00038 non-enabled lines are to be enabled. 


CLBNABLB 00041 Re sponse 


CLEXTBBN 00001 COBNAND COMPLETE 
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CLEXTEBN 00003 EXTERNAL 


CLEXTEBN 00006 fyj.Ti.leqe SLlfiSg: G 


CLEXTERN 00008 The EXTEBNAL coaaand simulates ao external interrupt to the 

CLEXTERN 00010 Tirtual aachine and return control tc that aachine. This 

CLEXTERN 00010 siaulates pressing the Interrupt key on the real computer 

CLEXTERN 00012 console* or other functions which cause an external 

CLEXTERN 00013 interrupt. Control is given to the virtual aachine 

CLEXTERN 00014 iaaediately. 

CLEXTERN 00023 ,- ■, 

CLEXTERN 00024 ( EXTERNAL | [code] | 

CLEXTERN 00025 ! EXT J J 

CLEXTERN 00026 »- 

CLEXTERN 00033 code 

CLEXTERN 00033 
CLEXTERN 00034 
CLEXTERN 00C35 
CLEXTERN 00036 


CLEXTEBN 00039 Resp o nses 


CLEXTERN 00041 None. Since control is given to the virtual aachine* any 
CLPLOSH 00001 response will be froa virtual aachine processing. 


is a hexadeciaal nuaber which is tc fceccse the 
interrupt code associated with the external 
interrupt* Valid codes are 1005 (CPU Tiaer), 1004 
(Clock Coaparator)* and all codes less than cr 
egual to X*FF*. 
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CLFLOSH 


CLFLU5H 


CLFLOSH 

CLFLOSH 

CLFLOSH 

CLFLOSH 

CLFLOSH 

CLFLOSH 

CLFLOSH 

CLFLOSH 

CLFLOSH 

CLFLOSH 

CLFLOSH 

CLFLOSH 

CLFLOSH 

CLFLOSH 

CLFLOSH 

CLFLOSH 

CLFLOSH 

CLFLOSH 

CLFLOSH 


CLFLOSH 


CLFLOSH 

CLFLOSH 

CLFLOSH 

CLFLOSH 

CLFLUSH 

CLFLOSH 

CLFLOSH 

CLFLOSH 


00003 

ELilSfl 

00006 

Elixilsae glass: D 

00008 

00009 

00010 

00011 

The FLUSH command halts and immediately purges or, 
optionally, holds the current output on a specified real 
unit record device. The device will resume activity with the 
next scheduled spool file. 

00020 

00021 

00022 

00023 



FLUSH | raddr [ALL] [HOLD] j 

1 F | 1 

■_ _ i 



00029 

00031 

00032 

raddr 

is the address (ecu) of the reel unit record 
output device whose activity is tc be terminated 
(that is, the real printer or punch). 

00035 

00035 

00036 

00037 

00038 

ALL 

if more than one copy of the current output file 
is being printed and this option is specified, all 
copies are deleted; if ILL is not specified, only 
the current copy is deleted and the next copy, if 
any, is printed or punched. 

00042 

00044 

00045 

HOLD 

HO 

if this option is specified, the terminated sped 
file is not purged, but is put in a system hold 
status and can be reset using the CHANCE command. 


00050 

Responses 




00052 

type raddr FLUSHED userid FILE * 

spoolid 


00054 

type 

either PRT or PUN 



00056 

00057 

raddr 

the real address of 
affected. 

the printer or 

punch to be 

00059 

00060 

userid 

the identification of 
the output. 6 

the user whe is 

tc receive 

00062 

OOC63 

spoolid 

a unigue number which 
VM/370 system. 

identifies the 

file to the 
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CLFORCE 

00008 







CLFORCE 

00011 

E£ililsas £lMS: A 





CLPORCE 

00012 

The FORCE coaaand 

allows the 

systea operator 

tc force a 

CLFORCE 

00O14 

LOGOUT of 

any other 

user on the 

systea. 



CLFORCE 

00018 

r“ 


_ 

_ 1 



CLFORCE 

00019 

| FORCE 

| userid [HOLD] 

1 



CLFORCE 

00020 

1 

1 


1 



CLFORCE 

00021 

L 



_j 



CLPORCE 

00026 

userid 

specifies 

the user identification of 

the user whe 

CLPORCE 

00028 


is to be : 

Logged out. 




CLFORCE 

00031 

BOLD 

specifies 

that the coaaunication line 

is to 

reaain 

CLFORCE 

00032 

BO 

connected 

to VM/370 once the user has 

been 

legged 

CLPORCE 

00033 


out. 





CLFORCE 

00036 

Responses 







CLFORCE 00037 The usee receives the noraal accounting message produced at 
CLPORCE 00039 LOGOUT and a logout sassage of the following feraat: 

CLFORCE 00041 LOGOUT AT hh:aa:ss zone weekday aa/dd/yy BY operator 


CLFORCE 00044 where "operator" is the identification of the systea 
CLPORCE 00045 operator who issued the FORCE coaaand. 


CLFORCE 00047 The priaary systea operator receives the following sassage: 

CLFORCE 00049 LINE raddr LOGOUT AS userid USERS - nnn BY operator 


CLPORCE 00052 
CLFORCE 00053 
CLFORCE 00054 
CLPREE 00001 


Where raddr is the line address, userid is the 
identification of the user who was logged cut, nnn is the 
nuaber of users reaaining on the systea, and operator is the 
systea operator who issued the FORCE coaaand. 
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CLFBBE 00003 

CLFHEB 00006 Priv i lege Class: D 


CLFREE 00008 The FREE coaaand reaoves a set of spool files belonging tc a 
CL FREE 00009 specified user froa a system hold status. A spocl tile held 
CLFREE 00010 by a spooling operator can only be freed by a spooling 
CLFREE 00011 operator; a spool file held by a user can fce freed by that 
CLFREE 00012 user or the spooling operator. A spool file can be in a 
CLFREE 00012 double hold status and can only be processed after toth 
CLFREE 00014 holds (systea and user) are reaoved. 


CLFREE 00021 
CLFREE 00022 
CLFREE 00023 
CLFREE 00024 
CLFREE 00025 
CLFREE 00026 
CLFREE 00027 


FREE 

i 

r 

1 

FR 

1 

|PRINTER) 


| userid 

1 PUNCH 

8 


1 

| ALL 

1 


1 

L ’ 

j 


CLFREE 00034 userid specifies the user whose spool files are to te 

CLPREE 00036 released froa a systea hold status. Tie user need 

CLFREE 00036 not be logged on, but his files aay have 

CLFREE 00038 previously been held by the systea HOLE ccmaand. 

CLFREE 00041 PRINTER specifies the type of files to be freed. If ALL is 

CLFREE 00043 p specified, all files for the specified user are 

CLFREE 00045 PRT freed. 

CLFREE 00047 PUNCH 

CLFREE 00049 PU 

CLFREE 00051 PCH 

CLFREE 00053 j&L 


CLFREE 00055 Responses 

CL HALT 00001 None. 
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CLHALT 


CLHALT 


CLHALT 

CLHALT 

CLHALT 

CLHALT 

CLHALT 

CLHALT 

CLHALT 

CLHALT 

CLHALT 

CLHALT 


CLHALT 


CLHALT 

CLHALT 

CLHALT 

CLHALT 

CLHALT 

CLHALT 

CLHALT 

CLHALT 

CLHALT 

CLHALT 

CLHALT 

CLHALT 


00003 HALT 

00006 Privi lege glass: A 


00007 The HALT coaaand allows the system operator tc terminate any 
00009 active channel prograa on a specified real device. 

"0016 ,- 1 

00017 | HALT | rad dr 1 

0 0018 «--J 


00024 

00026 

00028 

00029 

00031 


raddr 


is the address (ecu) of the real device which the 
systea operator wishes to stop. 


Note : This coaaand should be used only in eatreae cases and 
after careful consideration. Indiscriainate ese of this 
coaaand say cause unpredictable results. 


00033 Resp o nses 


00035 type raddr HALTED 


00037 ’type* is one of the following device types: 


00040 

00041 

00042 

00043 

00044 

00045 

00046 

00047 

00048 

00049 


EASD Direct access storage device 

TAPE Magnetic tape 

LINE Coaaunication line 

BDB Card reader 

PBT Line printer 

PUN Card punch 

GRAF Graphics device 

CONS Console 

CTCA Channel-to-channel adapter 
DEV Any other device 
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CLHOLD 


CLHOLD 


CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 

CLHOLD 


CLHOLD 


CLIPL 


00003 U2k£ 


00008 Esiiilsas Class: d 


00009 The HOLD coaaand is used to place user spool files in a 
00010 system hold status. The spooling operator has the ability tc 
00012 HOLD the files of any user of the systea. 

00O14 The systea HOLD status for a user is remembered even if the 
00014 user is not currently logged in. Both the user's files and 
00016 his HOLD status can be reset with the FREE ccaaand. 


00018 A spool file can be held by a user or by the system spooling 
00019 operator. A spool file held by a spooling operator cr a 
00020 user can only be freed by the spooling operator or the user* 
00021 respectively. A spool file can be in a double held status 
00022 and can only be processed if both holds (systea and user) 
00023 are reaoved. Non-class D users cannot free files held by a 
00024 Class D user. 


00031 

00032 

00033 

00034 

00035 

00036 

00037 


! HOLD j 

r i 

1 HO | 

(PRINTER) 

i j 

userid (PUNCH | 

1 1 

ihkk 1 

1 1 
L 

t. j 


00044 userid 

00044 

00046 


specifies the user whose spool tiles are tc be 
placed in a systea hold status. The user need not 
be logged on when the coaaand is issued. 


0O049 PBINTEH 
00051 P 

C 0053 PET 

00055 PUNCH 

00057 PU 

00059 PCH 

00061 ALL 


00063 Resp o nses 


00001 None. 


indicates the type of file that is to be held. 
If ALL is specified, all files fer the specified 
user are held. 
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CLIPL 


CLIPL 


CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 

CLIPL 


CLIPL 


CLIPL 

CLLINK 


00004 

121* 


00009 

2 £i 2 tilsas G 

90011 

00C12 

00912 

00013 

00014 

00015 

00015 

00017 

The IPL coanand siaulates an initial prograi lead function 
for a virtual aachine. IPL siaulates the LCAC key and the 
device address switches on the real caaputet ccnscle. The 
specified virtual address is accessed and the required 
input/output operations are perforaed to retrieve the IPL 
data. Hhen the siaulated load function is ccaplete, CP 
inititiates execution of the virtual aachine by leading the 
IPL PSB which was brought in during the siaulaticn process. 

00028 

00029 

00030 

00031 

00032 

00033 

00034 


0 •, 

\ IPL 

1 I 

1 

1 

A ......... 

S { r ill 

1 { |CLEAR | } | 

J ( vaddr [cyl-no] 1 NOCLEAHi } | 

1 C *• J } 1 

| ( systea—naae } | 



00041 

00041 

00042 

vaddr 

specifies the virtual address (ecu) of the device 
which contains the nucleus of the systea to be 
loaded. 

00045 

00046 

00046 

00047 

00048 

cyl-no 

If this operand is specified, CP leads the IPL 
data froa the specified virtual cylinder instead 
of the default, which is virtual cylinder zero. 
This operand is valid only for virtual direct 
access storage devices. 

00051 

00053 

00054 

00056 

00057 

systea- 

naae 

specifies that a copy of the naaed systea has been 
previously saved by using the CP SAVESYS coanand, 
and is to be brought into virtcal storage and 
given control. 

00060 

00061 

00062 

CLEAR 

CL 

specifies that the virtual storage space is to te 
cleared to binary zeros before the systea is 
loaded. 

00065 

00067 

00068 

NOCLgfrp 

NOCL 

specifies that the virtual storage space is not to 
be cleared to binary zeros before the systea is 
loaded* 

00071 

Responses 

00072 

00001 

After a successful IPL, any responses are those froa the 
IPLed systea. 
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CLLINK 

00004 

UM 


CLLINK 

00007 

Peiiiisaa £l§ss: a 


CLLINK 

CLLINK 

CLLINK 

00009 

00010 

00012 

The LINK command is used to make a 
user's virtual machine configuration, 
in the user directory. 

device available to a 
based upon information 


CLLINK 00021 
CLLINK 00022 
CLLINK 00023 
CLLINK 00024 


i .. 

| LINK | 

I I 

« 


[TO] userid vaddrl £ AS ] vaddr2 [mode] £[EAS£=] pass 


I 


CLLINK 00032 TO 

CLLINK 00037 T 


is an optional reserved word. If this word is 
omitted, the userid say not be TO or T. 


CLLINK 00040 
CLLINK 00040 
CLLINK 00041 
CLLINK 00043 


userid specifies the name of the user whose directory is 
to be searched for device vaddrl. An asterisk (*) 
■ay be used to specify that the device is in the 
directory of the user issuing the LINK command. 


CLLINK 00046 
CLLINK 00047 


vaddrl specifies the virtual device address (ecu) to be 
given in the user directory for userid. 


CLLINK 00051 AS is an optional reserved word. If this word is 

CLLINK 00055 A omitted, vaddr2 may not be A. 


CLLINK 00057 vaddr2 specifies the virtual address (ecu) which is to te 
CLLINK 00059 assigned to the device for this virtual machine. 


CLLINK 00062 Bode 
CLLINK 00063 
CLLINK 00063 
CLLINK 00064 


specifies the primary access reguested (read/only, 
write, or multiple), and the alternate access 
(read/only or write) desired if the primary access 
is not available. Valid modes are: 


CLLINK 00070 
CLLINK *0070 
CLLINK 00071 
CLLINK 00073 


R specifies that read/only access is requested. 
The link is not given if any ether user has 
the disk in write status. "8* is the default 
mode if the LINK is to another userid. 


CLLINK 00075 
CLLINK 00076 
CLLINK 00*77 


HR specifies that read/cnly access is requested, 
even if another user has the disk in write 
status. 


CLLINK 00079 
CLLINK 00000 
CLLINK 00081 


M specifies that write access is requested. 
The link is not given if any other user has 
the disk in read or write status. 


CLLINK 00083 
CLLINK 00084 
CLLINK 00085 


NR specifies that write (and read) access is 
requested if no other user has the disk in 
read or write status, hut thet an alternate 


werd] l 
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CLLINK 

00086 

CLLINK 

00087 

CLLINK 

00089 

CLLINK 

00090 

CLLINK 

00091 

CLLINK 

00092 

CLLINK 

00093 

CLLINK 

00095 

CLLINK 

00096 

CLLINK 

00097 

CLLINK 

00098 

CLLINK 

00100 

CLLINK 

00102 

CLLINK 

00104 

CLLINK 

00105 

CLLINK 

00106 

CLLINK 

00107 

CLLINK 

00108 

CLLINK 

00111 

CLLINK 

00114 

CLLINK 

00115 

CLLINK 

00116 

CLLINK 

00117 

CLLINK 

00118 

CLLINK 

00119 

CLLINK 

00120 

CLLINK 

00123 

CLLINK 

00122 

CLLINK 

00123 

CLLINK 

00124 

CLLINK 

00127 

CLLINK 

00128 

CLLINK 

00129 

CLLINK 

00130 

CLLINK 

00131 

CLLINK 

00132 


access of read/only is acceptable if others 
do have a link to the disk. 

M specifies that "nultiple" access is 
reguested. This leans that a trite-link is to 
be given to the disk unleee another user 
already has write access to it. in which case 
no link is to be given. 

MB specifies that a write-link ie to be given tc 
the disk unless another user already has 
write access to it; in this case, a read-link 
is to be given. 

MM specifies that a write-link is tc be given to 
the disk in all cases. 

Mote; If the node is oaitted. the default is tc B 
if the userid is another user; if the user is 
linking to one of his own disks, the default is 
the M user access aode M of either B, h, or M as 
specified in the user directory for his disks. 

PASS* is an optional reserved word 

password specifies a one to eight character string which 
aust aatch the access aode password for device 
"vaddrl" in the directory for user "userid". This 
should noraally be specified only when the LINK is 
executed by a virtual nachine (for eiaaple, froa 
CMS), since the password is net print suppressed 
when included with the LINK coaaand. The password 
cannot be one of the access node options if the 
default aode is to be used. 

Note; The access node password should not be 
confused with a user password. 

If the user is linking to one of his own disks, no password 
is required. Also, if the LINK is to a device whose 
password is "ALL", leaning the device aay be csed by all 
users, the password is not required. Otherwise, if the LINK 
is to any other userid, a password foi* the desired device 
■ust be provided* 
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CLLINK 00136 Note 


CLLINK 00137 The access allowed by LINK to userid vaddrl device is 
CLLINK 00138 summarized below: 


CLLINK 

00140 

Primary access requested 

11 R R 

R 

R 

R 

k W 

M 

W 

W 

4 

M M 

M 

M 

M 


CLLINK 

00141 

Alternate access (if any) 

1 i 



e 



Ft 


R 




B 

W 

CLLINK 

00142 

Read password in directory 

H N I 

y 

y 

y 











CLLINK 

00143 

Write password in directory 

1 1 




n y 

y 

Y 

y 

y 






CLLINK 

00144 

Mult, password in directory 

I 1 









n y 

y 

Y 

y 

y 

CLLINK 

CLLINK 

00145 

00146 

Any existing links 

1 1 N 

R 

w 

w 

N 

R 

R 

w 

4 

N 

r 

W 

W 

4 


CLLINK 00147 Access established: || N R a N fi NWNBNR nwhnsu 


CLLINK 00149 where: N=no or none; Reread; W=write; (^multiple; y=yes 


CLLINK 00151 Responses 


CLLINK 00154 ENTER READ PASSWORD: 

CLLINK 00158 RBBBBBBN 

CLLINK 00160 The read password should be typed in over the mask to 

CLLINK 00162 obtain read access to the desired disk. 

CLLINK 00165 ENTER WHITE PASSWORD: 

CLLINK 00167 IBBBRBSB 

CLLINK 00170 The write password should be typed in ever the aask to 

CLLINK 00171 obtain write access to the desired disk. 

CLLINK 00174 ENTER MOLT PASSWORD: 

CLLINK 00176 RBRKRRRB 

CLLINK 00179 The multiple password should be typed in over the aask 

CLLINK 09180 to obtain write access to a disk for which ether users 

CLLINK 00181 nay already have access. 

CLLINK 00185 Note : If LINK is issued froa a virtual machine with the 

CLLINK 00186 password included on a command line, and the jassword is 

CLLINK 00187 incorrect, then a count of thes^ incorrect passwords is 

CLLINK 00188 maintained by CP. If a total of ten such incorrect 

CLLINK 00189 passwords have been entered, then the LINK command from a 

CLLINK 00190 virtual machine is subsequently disallowed fer that user for 

CLLINK 09191 the remainder of the session. LINK can still be issued 

CLLINK 00192 directly fro® the terminal (that is, in CP console function 

CLLINK 00193 mode) , or LINK can be reinstated as a valid ccnmand from the 

CLLINK 0.0194 user*s virtual machine by logging out and legging in again. 

CLLINK 00194 (This procedure is designed to protect password security 

CLLINK 00195 from repeated calls to LINK from a virtual machine with 

CLLINK 00196 trial passwords.) 
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CLLINK 

00198 

CLLINK 

00200 

CLLINK 

00203 

CLLINK 

00201 

CLLINK 

00202 


CLLINK 

00204 

CLLINK 

00206 

CLLINK 

00206 

CLLINK 

00208 


CLLINK 

00219 

CLLINK 

00220 

CLLINK 

0"221 

CLLINK 

00222 

CLLINK 

00226 

CLLINK 

00227 

CLLINK 

00228 

CLLINK 

00229 

CLLINK 

00229 

CLLINK 

00230 


CLLINK 

00232 

CLLINK 

"0233 

CLLINK 

00234 

CLLINK 

00235 

CLLINK 

C0236 

CLLINK 

00237 

CLLINK 

00238 


CLLINK. 

03240 

CLLINK 

00241 

CLLINK 

"0242 

CLLINK 

00243 

CLLINK 

00247 

CLLINK 

00247 

CLLINK 

00249 

CLLINK 

00250 

CLLINK 

00250 

CLLINK 

"0251 


DASD vaddr2 LINKED R/O 

indicates that a read/only link to the givec disk has teen 
established, for a LINK request Kith a node of B or RR, and 
that no other users are linked to the sane disk in read 
write node. 


DASD vaddr2 LINKED B/B 

indicates that a read/write link to the given disk has been 
established, for a LINK request with a node cf U, NR, n , HR, 
or NB, and that no other users are linked to the sase disk. 


DASD vaddr2 LINKED B/0; H/B BY (nnn USERS}!; E/0 EY (nnn USERS}! 

(userid }| (userid }| 

i j 

indicates that a read/only link to the given disk has been 
established, for a LINK request with a node cf Rfi, tut warns 
the user that the disk is in read/write use ty sene users 
and possibly in read use by sone users. If only one user 
has access, the nuaber of users (nnn USERS) is replaced by 
userid. 


DASD vaddr2 LINKED R/B; R/O BY (nnn USERS} 

(userid } 

indicates that a read/write link to the given disk has been 
established for a LINK request with a node cf (1, HE, or MB, 
and inforas the user that the disk is also in rcad/only use 
by userid or by nnn users, (No other users have a read/write 
link to the disk.) 


DASD vaddr2 LINKED R/B; R/W BY (nn USERS} |; R/C EY (nnn USERS} | 

(userid } | (userid } | 

L J 

indicates that a read/write link to the given disk has been 
established for a LINK request with a node cf NN, tut warns 
the user that the disk is also in read/write use by scie 

users and possibly in read use by soae users. If only one 

user has access, the nuaber of users (nnn USERS) is replaced 
by userid. 
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CLLOADBP 00005 ItQAE£Jl£ 

CLLOADBP 00008 P rivi le g e C^ass: D 


CLLOADBF 00009 
CLLOADBF 00010 
CLLOADBF 00010 
CLLOADBF 00011 
CLLOADBF 00012 
CLLOADBF 00014 
CLLOADBF 00015 
CLLOADBF 00016 
CLLOADBF 00017 
CLLOADBF 00018 
CLLOADBF 00019 
CLLOADBF 00021 
CLLOADBF 00023 


The LOADBUF command is used to load the universal character 
set (UCS) buffer of a printer with a specified print train 
image, or to load the forms control buffer (FCB) with a 
specified image. This command should be used by the CLASS D 
operator to load the UCS or FCB buffer of a printer any tine 
the print train is changed, or if the buffer has been 
causing an excessive number of parity errors. The device 
must be drained before issuing the LOADBUF command. After 
the load has been executed, the contents of the buffer ace 
printed on the specified printer if VEH is specified. The 
printout must correspond to the description cf the specified 
buffer load that is printed in the Sfil publication 2£1J 2-Sil 
Cons ol Uni t C onponent Description (Order No. GA24-3312). 


CLLOADBP 00 n 35 
CLLOADBP 00036 
CLLOADBF 00037 
CLLOADBF 00038 


I LOADBUF | raddr 

i ; 


(UCS name [FOLD] [FEB]} | 
(FCB name } | 


CLLOADBF 

00046 

raddr 

specifies the address of the 

printer 

CLLOADBF 

0004 7 


FCB 

buffer is to be loaded. 


CLLOADBF 

00050 

DCS 

is 

a required reserved word 


CLLOADBF 

00052 

FCB 




CLLOADBP 

00054 

name 

is 

a 1 to 4 character name of 

the CCS 

CLLOADBF 

00056 


to 

be loaded. The supplied names are , 

CLLOADBF 

00058 


UCS 

- 1403 


CLLOADBF 

00061 


AN 

normal AN arrangement 


CLLOADBF 

00062 


HN 

normal HN arrangement 


CLLOADBF 

00063 


PCAN preferred character set. 

AN 

CLLOADBF 

00064 


PCHN preferred character set. 

HN 

CLLOADBF 

00065 



PL/I - 60 graphics 


CLLOAD8F 

00066 


QNC 

PL/I - 60 graphics 


CLLOADBF 

00067 


BN 

FOHTBAN, COBOL commercial 


CLLOADBF 

00068 


YN 

high speed alphanumeric 


CLLOADBF 

00069 


TN 

text printing - 120 graphics 

CLLOADBF 

00070 


PN 

PL/I printing - 60 graphics 

CLLOADBF 

00071 


SN 

text printing 84 graphics 


CLLOADBF 

00073 


UCS 

- 3211 


CLLOADBF 

00075 


All 

Standard Commercial 


CLLOADBF 

0 0076 


HI 1 

standard Scientific 


CLLOADBF 

00077 


Gil 

ASCII 
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CLLOADBP 

CLLOADBF 

CLLOADBP 

CLLOADBP 

CLLOADBP 

CLLOADBP 

CLLOADBP 

CLLOADBP 

CLLOADBP 

CLLOADBP 

CLLOADBP 

CLLOADBP 

CLLOADBF 

CLLOADBF 

CLLOADBP 

CLLOADBP 

CLLOADBP 

CLLOADBP 

CLLOADBP 

CLLOADBP 

CLLOADBP 

CLLOADBP 


CLLOADBP 


CLLOADBP 

CLLOADBP 

CLLOADBP 

CLLOADBP 

CLLOADBP 

CLLOADBP 

CLLOADBF 

CLLOADBP 

CLLOADBP 

CLLOADBP 


CLLOADBP 


CLLOADBP 

CLLOADBP 


00078 P11 PL/I 

00079 Tit Text Printing 

00081 FCB - 3211 only 


00085 


There is only one naee provided foe an FCB inage. 


00087 

90C88 


FCBl Space 6 lines/inch 

Length of page 66 lines 


00091 

00092 

00093 

00094 

00095 

00096 

00097 

00098 

00099 

00100 

00101 

00102 

00103 

00104 

00105 

00106 


Line Channel 

Represented Skip 

Specification 


1 

1 

3 

2 

5 

3 

7 

4 

9 

5 

11 

6 

13 

7 

15 

8 

19 

10 

21 

1 1 

23 

12 

64 

9 


00111 Opti ons 


00113 

POLD 

00118 

P 

00120 


00121 


00122 


00122 


00123 



specifies that the operator uishes the first three 
quadrants of the UCS buffer code tc te folded into 
the fourth quadrant. Polding should never te 
specified for print trains designed to print lever 
case characters, as these characters vill not be 
printed if the buffer is loaded with the FOLD 
option. 


00126 VER 

00130 V 

00131 


causes contents of the buffer to be printed on the 
specified printer for verification cf the buffer 
loading function. 


00135 £es£2a§a3 


00137 The contents of the DCS buffer print on the specified 
00139 printer if VER was specified. 
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CLLOADVF 

00008 




CLLOADVF 

00011 

£lizil££§ £ 1 ms: g 



CLLOADVF 

00013 

The LOADVFCB coaaand 

allows 

a user to specify the foras 

CLLOADVF 

00015 

control for a virtual 

spooled 

3211 printer. 

CLLOADVP 

00017 

•— 



CLLOADVP 

00018 

| LOADVFCB | vaddr 

FCB 

name J 

CLLOADVF 

00019 

J 1 


1 

CLLOADVP 

00020 



- j 


CLLOADVF 

00026 

vaddr 

specifies 

the virtual 

device address 

(ecu) of the 

CLLOADVF 

00027 


user's 3211 spooled 

printer. 


CLLOADVP 

00030 

FCB 

is a required reserved 

word. 


CLLOADVF 

00033 

naae 

specifies 

a system- 

defined name for 

the 3211 FCB 

CLLOADVF 

00034 


iaage which is to be 

the controlling virtual image. 

CLLOADVF 

00036 


There is i 

only one naae 

provided for an 

FCB image. 

CLLOADVF 

00038 


FCB1 

Space 6 lines/inch 


CLLOADVF 

00039 



Length of 

page 66 lines 


CLLOADVF 

00042 



Line 


Channel 


CLLOADVF 

00044 



Bepresented 

Skip 


CLLOADVF 

00045 





Specification 


CLLOADVF 

00047 




_ 



CLLOADVF 

00048 



1 


1 


CLLOADVF 

00049 



3 


2 


CLLOADVF 

00050 



5 


3 


CLLOADVF 

00051 



7 


4 


CLLOADVF 

00052 



9 


5 


CLLOADVF 

00053 



11 


6 


CLLOADVF 

00*54 



13 


7 


CLLOADVF 

00055 



15 


8 


CLLOADVF 

00056 



19 


10 


CLLOADVF 

00057 



21 


11 


CLLOADVF 

00058 



23 


12 


CLLOADVF 

00059 



64 


9 



CLLOADVP 

00063 

Responses 

CLLOCATE 

00*01 

None. 
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CLLOCATB 00003 


iOCAH 


CLLOCATB 00006 


EtilUSag £l2§s: E 


CLLOCATB n<)007 
CLLOCATB 00009 
CLLOCATB 00010 
CLLOCATB 00011 
CLLOCATB 00012 
CLLOCATB 00013 


The LOCATE com and provides the addresses cf CP control 
blocks associated with a particular user, a user's virtual 
device, or a real systea device. The contrcl tlccks and 
their use are described in the H achi ne 

EaciliiJiZl22» £L2aiafi£2£i§ Jgilids ££]HLSL£iBS (Order No. 

GC20-1807). 


CLLOCATB 00024 
CLLOCATB 00025 
CLLOCATB 00026 
CLLOCATE 00027 


LOCATE | [userid [vaddrj) ! 
LOC j [raddr ) I 


CLLOCATB 00034 
CLLOCATE 00035 
CLLOCATB 00036 


userid specifies the user identification cf the logged cn 
user. The address of this user's virtual aachine 
block (VHBLOK) will be provided. 


CLLOCATB 00038 vaddr 
CLLOCATE 00039 
CLLOCATE 00039 
CLLOCATB 00040 
CLLOCATE 00041 


causes the virtual channel block (VCUBLOK), 
virtual control unit block (VCUBLCK), and virtual 
device block (VDEVBLOK) addresses associated with 
this virtual device address to be printed with the 
VHBLOK address. 


CLLOCATB 00043 raddr 
CLLOCATB 00044 
CLLOCATB 00045 
CLLOCATB 00046 


causes the real channel block (BCHELCK), real 
control unit block (BCUBLOK), and the real device 
block (BDEVBLOK) addresses associated with this 
real device address to be printed. 


CLLOCATB 

00050 

Responses 


CLLOCATB 

00052 

I&£A££ 



CLLOCATE 

00C54 

VHBLOK 

* xxxxxx 


CLLOCATB 

00056 

LQ£A1£ 

jissleM 12 Me 


CLLOCATE 

CLLOCATB 

00C58 

00059 

VHBLOK 

XXXXXX 

VCHBLOK 

xxxxxx 

VCOBLOK 

XXXXXX 

CLLOCATB 

00061 

I&£AX£ IMM 


CLLOCATB 

CLLOCATB 

00063 

00064 

BCUBLOK 

XXXXXX 

BCUBLOK 

XXXXXX 

BDBVBLOK 

XXXXXX 
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CLLOCK 


CLLOCK 


CLLOCK 

CLLOCK 

CLLOCK 

CLLOCK 

CLLOCK 

CLLOCK 

CLLOCK 

CLLOCK 

CLLOCK 

CLLOCK 


CLLOCK 

CLLOCK 

CLLOCK 

CLLOCK 


CLLOCK 

CLLOCK 

CLLOCK 

uLLOvK 

CLLOCK 

CLLOCK 

CLLOCK 

CLLOCK 

CLLOCK 

CLLOCK 

CLLOCK 

CLLOCK 

CLLOCK 

CLLOCK 

CLLOCK 


CLLOCK 


CLLOCK 


00005 LOCK 


00008 Ulilileae Class: A 


00009 The LOCK command allows the system operator to bring into 
00010 real storage the virtual pages specified fcr the user and 
00011 lock these pages, thus excluding then froi future paging 
00012 activity. Contiguous virtual storage pages frca the first tc 
00013 last page specified are locked in real storage and are not 
00014 available for page swapping until an UNLOCK is issued or the 
00015 user does a LOGOUT, This coanand would be used for 
00017 frequently used pages of a high activity systea. It should 
00018 not be used indiscriminately because an excessive number of 
00019 locked pages can severely degrade system performance. 


00027 ,--1 

00028 | LOCK | userid fpage ipage J 

00029 i i I 

00030 •--' 


00035 

00036 


userid 


specifies the user identification of a logged in 
user. 


00038 fpage 
00040 


specifies the hexadecimal value of the first user 
page to be brought into storage and locked. 


00042 Ipage 

0004 3 

00044 

00045 


specifies the hexadecimal value cf the last user 
page to be brought into storage and lccked. If 
only one page is to be brought into storage, this 
field should the same as fpage. 


00047 Note: for fpage and Ipage, only the page numbers are 

00048 specified. For example, to lock USERA's virtual storage 
00049 locations X'12000* to X*2C000* in real storage, the 
00050 following command should be given: 

00052 f -j 

00053 | LOCK USERA 12 2C J 

00054 •-8 


00057 Response 

00059 COMMAND COMPLETE 
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CLLOGINP 00002 LOGI N 


CLLOGINP 00005 


EtilUgflg £ia3§: ALL 


CLLOGINP 00009 
CLLOGINP 00010 
CLLOGINP 00011 
CLLOGINP 00012 
CLLOGINP 00013 
CLLOGINP 00014 


The LOGIN command identifies a user to the VF/37C system and 
allows bin to access that system. On a successful LOGIN, CP 
creates a virtual machine configuration fioa information 
contained in the user directory. The ccmmand case say not be 
entered using any logical line-editing cnaracters, but the 
operands nay use these characters. 


CLLOGINP 00023 
CLLOGINP 00024 
CLLOGINP 00025 
CLLOGINP 00026 
CLLOGINP 00027 


r- - "" — 1 — - .- -- - - 

I LOGIN | userid [password] 

I L | 

| LOGON § 


[MASK] [NCIFL] j 
J 


j 


CLLOGINP 00033 
CLLOGINP 00034 
CLLOGINP 00036 


userid specifies the identifier assigned to the user in 
the user directory at the tine he was authorized 
to use the YM/370 system. 


CLLOGINP 00039 
CLLOGINP 00039 
CLLOGINP 00040 


password specifies the user's password. This field nay be 
specified if no protection (that is, masking 
characters) is desired. 


CLLOGINP 00044 BASK 

CLLOGINP 00047 fl 

CLLOGINP 00048 
CLLOGINP 00049 
CLLOGINP 00050 
CLLOGINP 00051 
CLLOGINP 00052 
CLLOGINP 00052 
CLLOGINP 00053 
CLLOGINP 00054 


requests the typing of masking characters (a 
series of overprinted characters) to ccver the 
password on terminals not eguipped with the print 
inhibit feature. This mask is tyfed cn the line 
following the prompting message rrcn CE requesting 
the user to enter his password. Should he forget 
to do this when he types in LOGIN, he may signal a 
carriage return after the prompt for the password 
is typed and CP will type oof the masking 
characters. 


CLLOGINP 00057 NOIPL 

CLLOGINP 00060 N 

CLLOGINP 00061 


specifies that the IPL device cr rate in the 
user's directory entry is not to be ised tor an 
automatic IPL. 


CLLOGINP 00064 Resp o nses 


CLLOGINP 00067 


ENTER PASSWORD: 


CLLOGINP 00068 
CLLOGINP 00C69 
CLLOGINP .00070 
CLLOGINP 00071 


indicates that the userid has been accepted. The user 
should type in the password, or signal a carriage return if 
a mask is desired for the password, and MASK was net 
included on the command line. 
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CLLOGINP 

CLLOGINP 

CLLOGINP 

CLLOGINP 

CLLOGINP 

CLLOGINP 

CLLOGINP 


CLLOGINP 

CLLOGINP 

CLLOGINP 

CLLOGINP 

CLLOGINP 


CLLOGINP 

CLLOGINP 

CLLOGINP 

CLLOGINP 

CLLOGINP 


CLLOGINP 

CLLOGINP 

CLLOGINP 

CLLOGINP 


00074 

LOGBSG- hh:aa:ss aa/dd/yy 


00076 

00077 

00077 

00078 

00079 

00080 

indicates the tine and date at which the system leg message 
was generated or most recently revised. If the user wishes 
to see all of the systen log messages, he must issue the CP 
coaaand QUERY LOGMSG. Any lines of the log message for which 
the first character is an asterisk, will be displayed at this 
point. 

00085 

00086 

FILES; (nnn} RDR, (nnnj PRT, {nnn} PUN 
(NO } (NO } (NO J 


00088 

00089 

00090 

This is oaitted if all counts are zero, otherwise 
indicates the nuaber of spool files that exist for the 
at LOGIN iiae. 

it 

user 

00092 

0CC94 

00096 

LOGON AT hh:aa:ss zone weekday aa/dd/yy 
or 

RECONNECTED AT hh:aa:ss zone weekday aa/dd/yy 


00098 

00099 

indicates the tiae, day of the week, and date at which 
LOGON or RECONNECT is complete. 

the 

00101 

00103 

00105 

LINE raddr LOGON AS userid USERS = nnn 

or 

LINE raddr RECONNECT userid USERS = nnn 


00107 

is the response to the primary system operator. 
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CLLOGOUT 


CLLOGOUT 


CLLOGOUT 

CLLOGOUT 

CLLOGOOT 

CLLOGOUT 

CLLOGOOT 

CLLOGOOT 

CLLOGOOT 

CLLOGOOT 

CLLOGOOT 

CLLOGOOT 

CLLOGOOT 


CLLOGOUT 

CLLOGOOT 

CLLOGOOT 


CLLOGOOT 


CLLOGOUT 

CLLOGOOT 

CLLOGOUT 

CLLOGOOT 

CLLOGOUT 

CLLOGOOT 

CLLOGOOT 

CLLOGOOT 

CLLOGOOT 

CLLOGOOT 

CLLOGOOT 

CLLOGOOT 

CLLOGOUT 

CLLOGOOT 

CLLOGOOT 

CLLOGOOT 


00003 It222M 


00006 Pr ivilege glass: ALL 


00007 The LOGOUT coaaaand allows the user to terainate virtual 
00008 aachine execution and disconnect his virtuel aachine frca 
^0009 the VM/370 systea. This coaaand causes all active spool 

00010 files to be closed, teaporary disks to be relinquished, 

00010 dedicated devices to be detached, and an accounting record 
00019 to be created for the user, 

00021 i- 1 

00022 | LOGOUT | [HOLD] J 

00023 | LOG | | 

00024 | LOGOFF | } 

00025 *---s 


00028 HOLD specifies that the coaaunication line is to be 
00032 HO left connected so that the user dees not have to 
00033 re-dial the VH/370 systea before legging in. 


00037 Responses 


00038 Session tines will be printed at the user's terainal when he 
00040 logs off. 

00042 CONNECT » hh:an:ss VIBTCPU= aaarss.hs TOTCPU = nan:ss.hs 

00043 is the actual clock and CPU tines spent in the user's 

00044 current session or the elapsed tine since the ACN1 coaaand 

00045 was last entered for the user. 


00049 

00049 

00050 


CONNECT hh:na:ss gives the actual clock tise spent in the 
current terminal session in 

hours: ainutes: seconds. 


00053 

00053 

00054 


VIBTCPU aaa:ss.hs gives the virtual CPU tine tsed in the 
current terminal session in 

ainutes:seconds.hundredths of seconds. 


00057 TOTCPU aaa:ss.hs gives the total CPU tine (including 
00057 virtual and overhead) used in the 
00C57 current terainal session in 
00059 ainutes:seconds.hundredths of seconds. 
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CLLOGOUT 00064 LOGOFF AT hh:aa:ss zone weekday aa/dd/yy 

CLLOGOUT 00066 is the response for a logout. 

CLLOGOUT 00068 LINE raddr LOGOFF AS userid USEES * nnn FORCED 

CLLOGOUT 00070 is the response if the logout is forced by a line tiaeout cr 

CLLOGOUT 00071 a terminal power-off. 

CLLOGOUT 00073 LINE raddr LOGOFF AS userid USEBS = nnn 

CLLOGOUT O0075 is the noraal response to the priaary systea operator. 

CLLOGOUT 00077 LINE DSC LOGOFF AS userid USERS * nnn 

CLLOGOUT 00079 is the response to the priaary system operator when logout 

CLLOGOUT 00079 occurs for a user who had previously disconnected using the 

CLLOGOUT 00080 DISCONN coaaand. 
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CLHSG 00003 HSG 


CLHSG 00006 Privilege Class ; B, ALL 


CLHSG 

CLHSG 

CLHSG 

CLHSG 

CLHSG 

CLHSG 

CLHSG 

CLHSG 

CLHSG 

CLHSG 

CLHSG 

CLHSG 

CLHSG 

CLHSG 

CLHSG 

CLHSG 

CLHSG 

CLHSG 

CLHSG 

CLHSG 

CLHSG 


CLHSG 

CLHSG 

00041 

00042 

ALL 

is for operator use only. It allows him tc 

broadcast a aessage to all logged in users. 

CLHSG 

CLHSG 

00044 

00045 

userid 

specifies a single user who is tc receive the 
mess age. 

CLHSG 

CLHSG 

00048 

00052 

OPERATOR 

OP 

specifies that the aessage is to fce sent tc the 
priaary system operator regardless of his userid. 

CLHSG 

CLHSG 

CLHSG 

00055 

00055 

00057 

msg-text 

specifies the text of the message which is to ke 
transmitted. As many characters may be entered as 
will fit on the remainder of the input line. 


CLHSG 

00060 

Responses 


CLHSG 

00062 

HSG PBOH OPERATOR 

: message-text 

CLHSG 

00064 

is the response 

to the user to whoa a message from the 

CLHSG 

00065 

system operator is 

directed* 


00007 The NSG command allows users to transmit message text tc a 

00008 specified userid or to the primary system operator, and to 

00009 allow the priaary system operator, to send message text to 

00010 one or all logged in users. It the user designated to 

00011 receive the aessage is not logged on or has suppressed the 

00012 receiving and typing of messages, the message is not 

00013 transmitted and the sender receives a diagnostic message to 

00014 this effect. If the operator sends a aessage tc ALJ,, he 

00015 receives a diagnostic message for every user with message 

00015 typing suppres<>ed. A aessage which is not received fcy a 

00017 user is not sabred and must be sent at a later time when the 

00018 user is receiving messages. The aessage will be typed out 

00018 at the terminal when the terminal is ready tc receive 

00019 output. If the terminal is entering data, the message is 

00021 held until a carriage return is received. 

00030 CLASS B; CLASS ALL: 

00031 | ■ 1 ■ i n i i — ii i —— ™ ■ |0 f ' — " — —-- — ——■— — — ■ . — — i 

00032 | NSG | (ALL ) msg-text | j HSG | (userid j msg-text | 

00033 IN I (userid } I I N I (OPFRATOB) | 

00034 | J (OPERATOR) | *•--J 

00035 *- a 
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CL MSG 

00067 

CLMSG 

00068 

CLHSG 

00070 

CLMSG 

00072 

CLMSG 

00073 

CLNOTRDf 

00002 


MSG FEOM userid : message—text 

This is the foraat of the message sent to another user cr to 
the system operator, where userid is the name of the sender. 

If the user receiving the message is the primary system 
operator, the alarm bell at the central ccmputer console 
will ring. 
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CLNOTBDY 00006 NOTE S AD Y 


CLNOTBDY 00009 Priv i lege Class: G 


CLNOTRDY 00011 The BOTBEADY coiaand causes a virtual device tc appear as if 
CLNOTRDY 00012 it had changed froa ready to not ready states. Ibis coiaand 
CLNOTRDY 00012 is for use with spooled unit record devices and virtual 
CLNOTRDY 00014 consoles only. Any I/O operation to the specified device ini 
CLNOTRDY nooiS progress at the tine of the connand will be ccipletea. On 
CLNOTRDY 00015 the next STABTIO (SIO) instruction, the not ready ccnditicn 
CLNOTRDY 00016 will be in effect. 

CLNOTRDY 00023 
OLNOTRDY 00024 
CLNOTRDY 00025 
CLNOTRDY 00026 

CLNOTRDY 00032 vaddr specifies the virtual device address (ecu). 


CLNOTBDY 00034 Respons e 


CLNOTRDY 00036 INVALID DEVICE TYPE 

CLNOTRDY 00037 is the response if the device specified by vaddz is not a 

CLORDEB 00001 spooled unit record device or a virtual conscle. 


» --- , 

| NOTFEADY ] vaddr | 

j NOTE 9 3 

a-..-___ a 
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CLOHDEB 


CLOBDEB 


CLORDER 

CLORDEB 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

■CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 


00004 

00007 Privilege C^ass: D, G 


00009 The ORDER coaaand places closed spool files cf a device type 
00010 in a specific order. A user nay deteraine via the uUERi 
00011 coaaand the filenaae, filetype, originating cserid and other 
00012 attributes of all of his files. For G users, the files .are 
00013 ordered as they are passed to the spool device within the 
00014 user's donain only. Class G users nay affect cnly their can 
00015 files. 


00024 

00025 

00026 

00027 

00028 

00029 


| ORDER | r (READER } (CLASS cl CLASS c2...}*| 

I ORD | |userid| (PRINTER } (spoolidl spoclid2...} 1 

| t {SYSTEM] (PUNCH } \ 

| j r j j 

9.....J 


00034 * Ordering aay be done using a coabinaticn cf CLASS c 

00035 specifications and spoolid specifications. For example; 

00037 ,---, 

00038 | ORDER PRINTER CLASS A 1963 CLASS C | 

00039 '---' 


00044 specifies that printer files will be prccessed in the 
00044 following order: all Class A files, the file with spoolid 
00046 1963, all Class C files. 


00050 

00050 

00051 


userid (for use by Class D users only) this allcws the 
spooling operator to nanipulate the spool files 
for a particular user. 


00054 STSTEH 

00054 

00056 


(for use by Class D users only) this allcws the 
spooling operator to aanipulate all sped files in 
the systea, regardless of userid. 


00059 READER specifies the type of files to be erdered. 

00061 R 

00063 BDR 


00065 PRINTER 
0D067 P 

00069 PRT 

COO71 PUNCH 

00073 PU 

00075 PCH 


00077 CLASS is a required reserved word which indicates 

00079 CL that files are to be ordered according to their 
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CLORDER 

00080 


class. 


CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

CLORDER 

00083 

00084 

00085 

00086 

00086 

00087 

c 

specifies class designations for input and output 
spool files. This specification allows files to be 
placed in the order of classes specified by CLASS 
cl, CLASS c2, and so forth, c is a one-character 
alphaseric field with values froe A tc Z and 0 to 
9. • 

CLORDER 

CLORDER 

CLORDER 

00090 

00091 

00093 

spoolid 

specifies that by the files 

spoolids are to be processed in 
the spoolids are given. 

tepresented the 
the order in which 

CLORDE8 

00096 

S22E2M2 



CLORDER 

CLORDER 

00100 

00102 

(nnnn) FILES ORDERED 
{HO } 


CLPURGE 

00001 

is the response to the user who issued the 

OKCER ccnaand. 
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CLPOBGE 


CLPOHGE 


CLPURGE 
CLPURGE 
CLPURGE 
CLPURGE 
CLPURGE 
CLPURGE 
CLPURGE 
CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 

CLPURGE 


00005 EJlfifiJS 


00008 Slilileje £lasg; D, G 


00010 
00011 
CO013 
00014 
00015 
00016 
00017 
00018 


The PURGE command reaoves closed spool files frci the system 
before they are printed or punched by the steeling devices, 
or before they are read by a user. If the user dees net have 
spooling operator (Class D) privileges, he may affect only 
his own files; the spooling operator, however, may purge any 
spool file in the systea. Any closed file nay te purged 
regardless of its status, as long as it has not been 
selected for processing. 


00C30 

00031 

00032 

00033 

00034 

00035 

00036 


i-- 

1 PURGE | r •» {{READER 1. r v) I 

I PUR | |userid} {{PRINTER} | ALL 1} I 

! J ] SYSTEM! {{PUNCH j | (CLASS cl CLASS c2 ...}* |} | 

! I l j ( I (spoclidl fpoolid2 ...} j} | 

I_! {ALL •- J) J 


00041 * Purging aay be done using a combination of CLASS c and 

00042 spoolid specifications. For example: 


00044 ,--t 

00045 | PURGE PRINTER CLASS A 1932 CLASS D 619 | 

00046 '--« 


00050 specifies that all Class A and Class D files and files with 
00051 spoolids 1932 and 619 are to be purged. 


00055 

00055 

00056 

userid 

(for use by Class D users only) allows the 
spooling operator to manipulate the spool tiles 
for a particular user. 

00059 

00059 

d0061 

SYSTEM 

(for use by the Class D user ocly) allows the 
spooling operator to manipulate all spool files cn 
the system, regardless of userid. 

00065 

00^66 

00067 

00069 

READER 

R 

RDR 

specifies the type of files that are tc be purged. 
If ALL is specified, ' files of all types are 
purged, and any other options specified are 
ignored. 

00071 

00073 

00074 

PRINTER 

P 

PRT 


00076 

00077 

00078 

PUNCH 

PU 

PCH 
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CLPURGE 

00080 

ALL 




CL PURGE 

00082 

ALL 

specifies that 

all files of the given type 

are to 

CLPURGE 

00083 


be purged. 



CLPURGE 

00087 

CLASS 

is a required 

reserved word which indicates that 

CLPURGE 

00090 

CL 

all files of 

the specified classes are 

to be 

CLPURGE 

00091 


purged. 



CLPURGE 

00094 

c 

specifies the 

classes of files of the indicated 

CLPURGE 

00095 


device type 

which are to be pcrged. c 

is a 

CLPURGE 

00095 


one-character 

alphaaeric field with values 

fron A 

CLPURGE 

00096 


to Z and fros 

0 to 9. 


CLPURGE 

00098 

spoolid 

specifies that 

only the files represented 

by the 

CLPURGE 

00100 


spoolids are to be purged. 



CLPURGE 

00104 

Besggages 

CLPURGE 

00108 

(nnnn) FILES PURGED 

CLPURGE 

00110 

{«0 ) 


is the response to the user who issued the pqbge ccssand. 


CLQUERYP 00001 
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CLQOEBYP 

00005 

turn 



CLQOEBYP 

00008 

££ilii§£e Class: A, 

B, D, E, G, ALL 

CLQOERYP 

00009 

The QUERY coaaand allows the user to request systea status 

CLQUERYP 

00011 

and aachine configuration information. Not all operands are 

CLQUERYP 

00012 

available in every 

privilege class. Operands available to 

CLQOERYP 

00013 

the specified privilege classes are given below. 

CLQOERYP 

00024 

CLASS A: 



CLQOERYP 

00027 

i- 


-— , 

CLQOERYP 

00028 

| QUERY 

| { PAGING 

} 1 

CLQOERYP 

00029 

1 Q 

|( PRIORITY 

userid } | 

CLQOERYP 

00030 

«—- 


* 

CLQOERYP 

"0032 

PAGING 

displays the current systen paging activity index. 

CLQOERYP 

00034 

PAG 



CLQOERYP 

00036 

PRIORITY 

displays 

the current priority cf the specified 

CLQOERYP 

"0040 

PRIOR 

userid. This is established in the user directory 

CLQOERYP 

0C040 


but nay be overridden by the SET PRIORITY nn 

CLQOERYP 

00041 


coaaand. 


CLQUERYP 

00045 

CLASS B: 



CLQUERYP 

00048 

l— ' 


i 

CLQUERYP 

00049 

| QUERY 

1 I (DASD } 

} 1 

CLQUERYP 

00050 

1 Q 

11 (TAPES } 

} i 

CLQUERYP 

"0051 


j ( (LINES } 

) 1 

CLQUERYP 

00052 

1 

1 ( (ua } 

} 1 

CLQUERYP 

00053 

1 

| ( (STORAGE} 

} II 

CLQUERYP 

00054 

1 

l( (ALL } 

} 1 

CLQUERYP 

00055 

1 

i { (raddr } 

1 1 

CLQUERYP 

00"56 

\ 

I ( 

} i 

CLQUERYP 

00057 

1 

I ( SYSTEM 

raddr } | 

CLQUERYP 

00058 

1 

|( DUMP 

} 1 

CLQUERYP 

00059 

i_ 


j 

CLQUERYP 

00064 

DASD 

displays a 

list showing the real status of all the 

CLQUERYP 

00065 

DA 

devices within the reguested class. If raddr is 

CLQUERYP 

00067 


requested. 

the status of just that device is 

CLQUERYP 

00068 

TAPES 

displayed. 

A STORAGE request displays the size 

CLQUERYP 

00"70 

TA 

of real aain storage. EASD represents disk cr 

CLQUERYP 

0 0072 


drua devices, TAPE represents ccaaunication 

CLQUERYP 

00073 

LINES 

lines, and 

UR represents unit record devices 

CLQUERYP 

00076 


(card reader, printers, card punches). 

CLQUERYP 

00077 

UR 



CLQUERYP 

00079 

STORAGE 
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CLQUBRYP 

CLQUERYP 


CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQOEHYP 

CLQOERY? 

CLQUERYP 

CLQOERYP 

CLQUERYP 


CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQnERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUBRYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 


00081 

STOH 


00083 

ALL 


00085 

raddr 


00089 

00090 

00091 

00092 

00093 

SYSTEM raddr 

SYS returns to the operator the userid, address, and 

access aode of virtual disks which reside on the 
specified raddr (ecu) belonging tc logyed-cn 

users. 

00096 

00098 

DUMP 

DU 

returns to the operator the type cf device and 
device .address of the ABEND d.uap unit. 

00101 

A A i A C 

CLASS D: 


00106 

U0107 

00108 

00109 

00110 

00111 

i QUERY 

1 Q 

1 

1 

1 

A .. __ 

| ( FILES r v ) 'l 

|((READER } fspooiidl } | 

| {(PRINTER) |ALL | } | 

| ((PUNCH } J ) | 

I( HOLD } I 

« 



00116 

00118 

00119 

00120 

00121 

FILES 

F 

returns to the requestor the nunhet cf spooled 
input and output files. The user receives the 
total count in the systea. Files which are 

currently being processed are not included in the 
totals. 

00125 

00127 

00130 

00131 

00133 

00135 

00137 

READER 

R 

RDR 

PRINTER 

P 

PRT 

specifies that intonation is to te returned 
concerning spool files of a specified type. The 
user receives intonation on all spocl files in 
the systea. 

00139 

00141 

00143 

PUNCH 

PU 

PCH 


00145 

00148 

HOLD 

H 

returns to the operator a list cf csers whese 
output is being held by the HOLD ccsaand. 

00151 

00152 

00154 

00154 

00155 

00156 

spoolid 
ALL 

for PRINTER or PUNCH files, the nusber of records, 
filename, filetype, nuaber of copies, output 
class, and HOLD status will be returned. Fcr 
READER files, nuaber of records, filenaoe, 
filetype, logical record length, acd userid of the 
file originator will be returned. If ALL is 
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CLQUERYP 00156 
CLQUERYP 00157 


specified, the status of all files cf the 
specified type is given. 


CLQOERYP 00160 CLASS E: 

CLQOERYP 00162 Sane as Class A. 


CLQOERYP 00165 CLASS G: 


CLQOERYP 

00168 

r* 





— 

CLQUERYP 

00169 

i 

QUERY 

1 ( 

l TIME j 


} 

CLQOERYP 

00170 

i 

Q 

1 ( 

{ FILES } 


) 

CLQOERYP 

00171 



1 ( 

(SET } 


} 

CLQUERYP 

00172 



1 ( 

{ TERMINAL} 


} 

CLQOERYP 

00173 

§ 


9 i 



} 

CLQUERYP 

00174 

i 


1 t 

[ VIRTUAL] 

(DASD 

}} 

CLQOERYP 

00175 



i t 


{TAPES 

J) 

CLQOERYP 

00176 

i 


1 ( 


(LINES 

}} 

CLQUERYP 

00177 

i 


1 ( 


(UR 

}) 

CLQOERYP 

00178 

i 


i ( 


(STORAGE}} 

CLQOERYP 

00179 

i 


1 t 


* {ALL 

}} 

CLQUERYP 

00180 

j 


1 { 


(vaddr 

i> 

CLQOERYP 

00181 

i 


It 



) 

CLQUERYP 

00182 

i 


1 ( 

LINKS 

vaddr 

} 

CLQOERYP 

00183 

i 


1 ( 


r 


CLQOERYP 

00184 

i 


1 C 

( READER ) 

jspoolid |} 

CLQOERYP 

00185 

i 


9 1 

( PRINTER} 

| ALL 

1) 

CLQOERYP 

00186 

i 


H 

( PUNCH } 

L 

J } 


CLQUERYP 00187 *~ 


CLQOERYP 00191 * This is the default only if the keyword VIRTUAL is 
CLQOERYP 00192 entered. If VIRTUAL is omitted, one of the choices oust fce 
CLQOERYP n 0193 Bade. 


CLQOERYP 00196 TIME 

CLQOERYP 00198 T 


returns to the requestor the connect and CEU time 
spent in the current terminal session. 


CLQOERYP 00200 FILES 

CLQUERYP 00203 F 

CLQOERYP 00203 
CLQOERYP 00204 


returns to the requestor the nuafcer cf spooled 
input and output files for his virtual machine. 
Files which are currently being piccessed are not 
included in the totals. 


CLQOERYP 00207 SET 

CLQOERYP 00209 S 


returns to the requestor the status of t»«= SIT 
command functions. 


CLQOERYP 00211 
CLQUERYP 00213 
CLQOERYP 00214 


TERMINAL returns to the requestor the opticns for terminal 
TERN input and output as specified in the TERMINAL 

Cobb and. 


CLQUERYP 00217 
CLQOERYP 00218 
CLQOERYP 00219 


VIRTUAL returns to the requestor the status cf the virtual 

V devices within the class selected. If STOFAGE is 

requested, the size of the virtual stcrage is 
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C LQOEBYP 
CLQUERYP 
CLQUERYP 
CLQUERYP 
CLQOERYP 

00 220 
00223 
00223 
00224 
00225 


printed* If vaddr is specified* the status of the 
one device is returned. This keyverd is cpticnal. 
However* if it is not specified* ALL is not the 
default; an error aessage is geneiated if device 
type is not specified. 

CLQUERYP 

00227 


Virtual Device Types: 

CLQUERYP 

CLQUERYP 

00230 

00232 


DASD 

DA 

virtual direct access stcrage devices 

CLQUERYP 

CLQUERYP 

00234 

00236 


TAPES 

TA 

virtual aagnetic tape device 

CLQUERYP 

00238 


LINES . 

virtual coisaunication lines 

CLQUERYP 

00240 


UR 

virtual unit record devices 

CLQUERYP 

CLQUERYP 

00242 

00244 


STORAGE 

STOB 

virtual storage 

CLQUERYP 

00246 


ALL 

return status of all virtual devices 

CLQUERYP 

CLQUERYP 

CLQUERYP 

00249 

00251 

00252 

LINKS 

L 

The userid* device address* and access aede are 
printed at the terainal for all vsers linked to 
the specified virtual address. 

CLQUERYP 

CLQUERYP 

CLQUERYP 

00256 

00257 

00259 

READER 

R 

RDR 

specifies 

concerning 

that inforaation is tc be typed cut 
the user*s spool files. 

CLQUERYP 

CLQUERYP 

CLQUERYP 

0 0261 
n 0263 
00265 

PRINTER 

P 

PRT 



CLQUERYP 

CLQUERYP 

CLQUERYP 

00267 

00269 

00272 

PUNCH 

PU 

PCH 



CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

00275 

0 0276 
n 0277 
00278 

0 0279 
00280 
00280 
*0281 

spoolid 
ALL 

for PRINTER or PUNCH files* the nuaber of records* 
filename* filetype* nuaber of copies* output 
class* and HOLD status are returned. Fcr READER 
files* nuaber of records* filetaae* filetype* 
logical record length* and userid cf the file 
originator are returned. If ALL is specified* the 
status of all files of the specified type is 
given. 
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CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYP 

CLQUERYQ 


CLQUERYQ 


CLQUERYQ 

CLQUERYQ 

CLQUERYQ 

CLQUERYQ 

CLQUERYQ 

CLQUERYQ 

CLQUERYQ 

CLQUERYQ 

CLQUERYQ 

CLQUERYQ 


CLQUERYQ 

CLQUERYQ 


00287 CLASS ALL: 


00291 ,-- 

00292 1 QUERY | {LOGMSG } | 

00293 | Q I (NAM ES } 1 

*0294 I I (USERS (userid] ) j 

*0295 I | (userid } I 

0 0296 •--- 1 


00299 LOGMSG returns to the requestor the log messages of the 

00302 LOG day. 


00304 NAMES 

00307 M 

00308 

00309 

00310 


returns to the requestor a list of all the users 
logged in and the real address c£ the line tc 
which each is connected. If the user is 

disconnected, DSC is printed instead cf the line 
address. 


*0314 USERS 

00317 0 

00318 

00319 

00319 

00320 

00321 


returns to the requestor the nuaber of logged in 
users and the nuaber of users dialed to other 
virtual machines. If userid is specified, the 
userid and device address of the user's terminal 
are printed if he is logged on. If the specified 
user is not logged on, a message to that effect 
will be printed. 


00324 

00325 

00326 

00002 


userid prints the userid and the device address of the 
user's terminal if he is logged ci. It the user 
is not logged on, a message to this effect is 
issued. 


00005 

Responses 


00007 

The following are 

00008 

vaddr denotes a vi 

00010 

QfiMX all - 

■ Class 

00012 

Produces the same 

00013 

issued: 


00*16 

QUERY 

STORAGE 

00018 

QUERY 

OR 

*0020 

QUERY 

LINES 

00022 

QUERY 

DASD 

00024 

QUERY 

TAPES 

00027 

2MI I2.ASJ2 

- Class 

90*29 

DASD raddr 

FREE 
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CLQUERYQ 00030 
CLQUERYQ 00032 


CLQUERYQ 00034 

CLQUERYQ 00035 
CLQUERYQ 00036 
CLQUERYQ 00037 


CLQUERYQ 00039 

CLQUERYQ 00040 
CLQUERYQ 00041 
CLQUERYQ 00042 
CLQUERYQ 00043 
CLQUERYQ 00044 


CLQUERYQ 00046 

CLQUERYQ 00048 
CLQUERYQ 00049 
CLQUERYQ 00050 
CLQUERYQ 00050 
CLQUERYQ 00051 


CLQUERYQ 00054 

CLQUERYQ 00056 

CLQUERYQ 00057 
CLQUERYQ 00059 


CLQUERYQ 00061 

CLQUERYQ 00062 
CLQUERYQ 00C64 


CLQUERYQ "0066 

CLQUERYQ 0C067 
CLQUERYQ 00068 
CLQUERYQ 00069 


This response is given if the real device designated by 
raddr is not allocated to the CP system or tc any user. 


DASD raddr ATTACH TO userid vaddr 

This respoase is given if the real device specified by raddr 
is attached to a user's (userid) virtual machine at virtual 
address vaddr. 


DASD raddr CP SYSTEM volid nnn 

This response is given if the rea^. device designated ty 
raddr is allocated to the systee for use as user's 
minidisks, nnn is the number of active user's xinidisks cn 
the physical disk and volid is the volume serial number of 
the real disk. 


DASD raddr CP OHNED volid nnn 

This response is given if the real device designated ty 
raddr is used by the system for paging and spooling 
activity, nnn is the number of active user's minidisks (if 
any) on the physical disk and volid is the vcluie serial 
number of the real disk. 


QUER Y TAPES - Class B 
TAPE raddr FREE 

This response is given if the real tape device designated by 
raddr is not allocated to the system or to any user. 


TAPE raddr CP SYSTEM 

This response is given if the real tape device designated ty 
raddr is attached to CP for its exclusive use. 


TAPE raddr ATTACH TO userid vaddr 

This response is given if the real tape device designated by 
raddr is attached to a user's (userid) virtual machine at 
virtual address vaddr. 
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CLQOERTQ 

CLQUERYQ 

CLQOERTQ 

CLQUERYQ 

CLQOERTQ 

CLQOERTQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQUERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 


CLQOERYQ 

CLQOERYQ 

CLQOERYQ 


CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 


00079 flua&x its - Class B 

00081 r t 

00083 type raddr SPOOL CLS [a...] | DRAIN ED | 

00084 | STARTED| 

00085 L J 

00089 This response is given for each unit record device attached 

00090 to the systea for spooling activity. 


00093 type 

00094 

00095 


is one of the following: RDR 

PRT 

PUN 


00097 raddr 


is the real device address (ecu). 


00099 a 
00100 
00101 
00102 


specifies the classes serviced fcy the output 
device. This field does not type £cr a BB£ device. 
Up to four classes nay be serviced ky an output 
device. 


00105 

00105 

00107 


DRAINED indicates that the device is not currently 
available for processing. A START ccasand Bust ke 
issued to activate the device. 


00109 STARTED indicates that the device is available for 
00110 spooling activity. 


00113 type raddr ATTACH TO userid vaddr 

00115 This response is given if the device is attached tc a user's 
00116 virtual aachine at vaddr. 


00120 fiU£R Y LINES - Class B 

00122 CONS raddr LOGIN AS userid 

00124 indicates that the user represented by userid is currently 

00125 logged on at the systea console located at raddr. 

00127 LINE raddr FREE 

00128 indicates that the coBBunication line at real address raddr 
O0129 is not in use. 

90131 LINE raddr LOGIN AS userid 

00132 indicates that the user specified by userid is currently 
00133 logged on at the device connected to the ccibuo ication line 
00134 located at raddr. 

00136 LINE raddr ATTACH TO userid vaddr 
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CLQUERYQ 

CLQUERYQ 

CLQUERYQ 


CLQOERYQ 

CLQOERYQ 

CLQOERYQ 


CLQOERYQ 

CLQUERYQ 

CLQOERYQ 

CLQOERYQ 


CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 


CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 

CLQOERYQ 


00137 

00138 

00139 

indicates that the coaaunication line at 
to the virtual eachine represented by 
address vaddr. 

racdr is attached 
userid at virtual 

001*2 

QUERY STORAGE - Class B 


00144 

STORAGE = XXXXXK 


00146 

xxxxx - size of real storage in aultiples 

of 1024 bytes. 

001*9 

QUERY raddr - Class B 


00151 

00152 

The response to this connand depends upon 
located at raddr. 

the type cf device 

00154 

See QUERY DASD, TAPES, UR, and LINES responses. 

00158 

£U]2RY SYSTEM £add£ - Class B 


00159 

00160 

00161 

This coaaand reguests the nuaber of user 
on the physical disk located at raddr. 
fora: 

■iridisks residing 
Ore entry of the 

00163 

userid aode vaddr 


00165 

is given for each ainidisk. 


00166 

00167 

M aode N is the type of access the user has 
or W (Write). 

: either R (Read) 

00170 

00171 

userid is the identification of the user who owns the 
ainidisk. 

00173 

00174 

vaddr is the virtual address by which the user refers tc 
the ainidisk. 

00180 

QUERY J2J2M£ - Class D 


00182 

00183 

type raddr DUMP UNIT (CP ) 

(ALL) 


00185 

00186 

indicates that the device of device type 
raddr is the Systea Duap Unit. 

•type* lccated at 


6 
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CLQOERYQ 00190 QOERT F ILES - Class D 

CLQUERYQ 00197 r i r t r t 

CLQOERYQ 00199 FILES: |NO | RDR, |NO | PRT, |NO | PUN 
CLQOERYQ 00200 |nnn| |nnn| Jnnnj 

CLQOERYQ 00201 ». J t J c j 

CLQOERYQ 00203 This response gives the total number of spool files in the 

CLQOERYQ 00204 systei. 


CLQOEBYQ 00207 20ERY READER - Class D 

CLQOERYQ 00210 0SERID FILE CLS RECDS ORIGIN DATE TIME NAME TYPE 

CLQOERYQ 00212 useridl spoolid norec userid2 am/dd/yy hh:sBi:s£ filenane filetype 
CLQOERYQ 0^215 
CLQUERYQ 00217 
CLQUERYQ 00219 

CLQOERYQ 00221 Only one file will be listed for a QUERY READER spcciid 

CLQOERYQ 00222 coaaand. 

CLQUERYQ 00227 useridl specifies the identification of the user who is to 
CLQOERYQ 00228 receive the file. 

CLQUERYQ 00231 spoolid a unique, systea assigned nuaber which is used by 
CLQOERYQ 00232 VM/370 to identify the file. 

CLQOERYQ ^0234 norec gives the nuaber of logical records contained in 

CLQUERYQ 00235 the file. 

CLQOERYQ 00237 userid2 specifies the identification of the user whc 

CLQOERYQ 00239 created the file. 

CLQUERYQ 00241 ma/dd/yy gives the date the tile was created in 

CLQOERYQ 00242 aonth/day/year. 

CLQUERYQ 00244 hh:aa:ss gives the tiae of file creation in 
CLQOERYQ 00245 hours: ainutes:seconds. 

CLQUERYQ 00248 filename gives the filename assigned to the file (if any}. 

CLQUERYQ 00251 filetype gives the filetype assigned to the file (if any}. 


22III PRINTER - Class D 

USERID FILE CLS RECDS CPY HOLD DATE TIME NAME TYPE 

useridl spoolid a norec nn hold mra/dd/yy hh:inn:ss filenane filetype 


Only one file will be listed for a QUERY PRINTER spoolid command, 
useridl specifies the identification of the user who is 


CLQOERYQ 00256 

CLQOERYQ 00258 
CLQOERYQ 00260 
CLQUERYQ 00262 
CLQUERYQ 00264 
CLQOERYQ 0.0266 
CLQOERYQ 00269 

CLQUERYQ 00272 
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CLQUERYQ 

00273 


to receive the file. 

CLQOERYQ 

00276 

spoolid 

a unique, systea assigned nunber which is used 

CLQUERYQ 

00277 


by VM/370 to identify the file. 

CLQUERYQ 

00280 

a 

the output class of the file. 

CLQUERYQ 

00283 

norec 

gives the nunber of logical records contained in the file. 

CLQOERTQ 

00286 

nn 

is the nunber of copies of the output file 

CLQOERYQ 

00287 


to be produced. 

CLQOERTQ 

00290 

hold 

is the file hold status and is either: 

CLQOERYQ 

00292 


NONE- no hold 

CLQOERYQ 

00294 


USER — user hold 

CLQOERYQ 

00296 


SYS - systen hold 

CLQOERYQ 

00298 


USYS — systea and user hold 

CLQOERYQ 

00301 

na/dd/yy 

gives the date the file was created in nonth/day/year. 

CLQOERYQ 

00304 

hh :aa:ss 

gives the tiae of file creation in hou£s:vinutes:seconds. 

CLQOERYQ 

00307 

filename 

gives the filenane assigned to the file (if any). 

CLQOERYQ 

00310 

filetype 

gives the filetype assigned to the file (if any). 

CLQOERYQ 

00314 

fiU£RX PUNCH - Class D 

CLQOERYQ 

00317 

USERID 1 

FILE CLS RECDS CPY HOLD DATE TIME NAME TYPE 

CLQOERYQ 

00319 

userid 1 spoolid a norec nn hold nn/dd/yy hh:aa:ss filename filetype 

CLQOERYQ 

00321 

• 

• 

CLQOERYQ 

00323 


• 

CLQOERYQ 

00325 

• 

* 

CLQOERYQ 

00327 

Only one 

file will be listed for a QUERY PUNCH spcclid coaaand. 

CLQOERYQ 

00332 

useridl 

specifies the identification of the user who is 

CLQOERYQ 

00333 


to receive the file. 

CLQOERYQ 

00336 

spoolid 

a unique, systen assigned nunber which is used 

CLQOERYQ 

00337 


by VH/37 0 to identify the file. 

CLQOERYQ 

00340 

a 

the output class of the file. 

CLQOERYQ 

00343 

no rec 

gives the nunber of logical records contained in the file. 

CLQOERYQ 

00346 

nn 

is the nunber of copies of the output file to be produced. 

CLQOERYQ 

00349 

hold 

is the file hold status and is either: 

CLQOERYQ 

C0351 


NONE - no hold 

CLQOERYQ 

00353 


USER - user hold 

CLQOERYQ 

00355 


SIS - systea hold 
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CLQUERYQ 00357 
CLQUERYQ 00360 
CLQUERYQ 00363 
CLQUERYQ 00366 
CLQUERYQ 00369 


mm/dd/yy 
hh:an:ss 
filename 
filetype 


USYS - system ana user hold 
gives the data the file was created in month/day/year. 
gives the tine of file creation in hours:minutes:seconds. 
gives the filename assigned to the tile (if any), 
gives the filetype assigned to the file (if any}. 


CLQUERYQ 00373 


2fi£M - Class D 


CLQUERYQ C0375 
CLQUERYQ 00377 
CLQUERYQ 00378 
CLQUERYQ 00379 
CLQUERYQ 00380 
CLQUERYQ 00381 
CLQUERYQ 0^383 
CLQUERYQ 00384 
CLQUERYQ 00385 
CLQUERYQ 00386 


r i r i r t 

HELD : |NO | RDR, (NO | PRT „ jNO | PUN 

|nnn| jnnnj innnj 

l J 4. J Li 

r i 
| ALL j 

userid - jflDR j , ... 

| PRT | 

» | PUN| 

L j 


CLQUERYQ 00388 
CLQUERYQ 00389 
CLQUERYQ 00390 
CLQUERYQ 00391 


The first response gives the total number of files within the 
system which are held. The second response gives the type 
of hold (if any} for any user in the system for which a 
hold is in effect. 


CLQOERYQ 00394 QUERY PAGIN G - Class A 
CLQUERYQ 00397 PAGING nn„ SET ai, RATE nnn/SEC 


CLQUERYQ 00400 nn 
CLQUERYQ 00401 


a percentage specifying the paging overhead threshold 
at which the system is currently running. 


CLQUERYQ 00404 mm 
CLQUERYQ 00405 


a percentage specifying the paging overhead threshold 

which was established by default ot by the SET PAGING command 


CLQOERYQ "0408 


nnn/SEC specifies the current paging rate in pages {nn} per second. 


CLQUERYQ 00411 

CLQUERYQ 00414 
CLQUERYQ 00416 


QUERY PRIOR ITY userji - Class A 
userid PRIORITY * nn 

nn — the assigned priority of the specified user. 
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CLQOERYQ 00419 ! QOBB T L OOHS G - Class ALL 

CLQUERYQ 00423 
CLQOERYQ 00424 
CLQUERYQ 00425 
CLQOEHYQ 00426 
CLQUERYQ 00427 

CLQUERYQ 00429 logasg additional text lines 

CLQOERYQ 00430 

CLQOERYQ 00431 . . 

CLQOERYQ 00432 . . 

CLQOERYQ 00435 this gives all lines (both with an asterisk and without) in 
CLQOERYQ 00436 the log Message file* 


CLQOEHIQ 00439 flfiSfil BABES - Class ALL 

CLQOERYQ 00443 userid- (DSC }# ... 

CLQOERYQ 00444 , (caddr) 

CLQOERYQ 00445 . . 

CLQOERYQ 00446 

CLQOERYQ 00447 userid - (DSC )# ... 

CLQOERYQ 00448 (raddr) 

CLQOERYQ 00454 this gives a list of all logged in users; if the user is, 

CLQOERYQ 00454 currently connected# the real address tc which he is 

CLQOERYQ 00455 connected is given (raddr); if be is not connected to the 

CLQOERYQ 00456 systes DSC is given. 


CLQOEHIQ 00459 QOEB Y OSEBS - Class ALL 
CLQOERYQ 00463 nnn USERS ana DIALED 

CLQOERYQ 00466 nnn specifies the total nuaber of logged-in users. 

CLQOERYQ 00468 ana specifies the total nuaber of users dialed tc virtual 

CLQUERYQ 00469 aachines. 


CLQOERYQ 00472 QU ERY fisetii - Class ALL 

CLQOERYQ 00474 userid - raddr 

CLQOERYQ 00475 gives the real address (raddr) to which the specified user 

CLQUERYQ 00476 is connected. 


CLQOEHIQ 00478 22BSI TIME - Class G 

CLQOERYQ 00480 TIHE IS HOW hh:aa:ss zone weekday na/dd/yy 


* logasg text line 1 

• • 

• • 

• • ■ 

* logasg text line n 
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CLQOERYQ 00481 gives the current real clock time in hours:■inuteszseconds, 
CLQUERYQ 00482 the time zone (e.g. EST), the day cf the week, and the 
CLQOERYQ 00483 calendar date - aonth/day/year. 

CLQUERYQ 00485 CONNECT hh:aa:ss VIHTCPU aaa:ss:hs TOTCPU BBit:ss:hs 

CLQOEHYQ 00487 gives the tiae spent in the current terminal session. 

CLQUERYQ 00491 CONNECT hh:na:ss gives the actual clock tine sjent in the 
CLQOEHYQ 00491 current terminal session in 
CLQOEHYQ 00492 hours:minutes:seconds. 


CLQOERYQ 00495 VIHTCPU aaa:ss:hs gives the virtual CPU time used in the 
CLQUERYQ 00495 current terminal session in 
CLQUERYQ 00496 minutes:seconds:hundreths cf seconds. 

CLQOERYQ 00499 TOTCPO «aa:ss:hs gives the total CPU time (including 
CLQOERYQ 00499 virtual and overhead) used in the 
CLQOERYQ 00499 current terainal session in 
CLQUERYQ 00500 minutes:seconds:hundredths of seconds. 


CLQOERTR 00003 flOgRI PILES - Class G 

CLQOERYR 00007 r r. i r l 

CLQUERYR 00009 PILES: |nnn| RDR, |nnn| PBT, |nnn| PON 
CLQOERYR 00010 |NO | |NO | |NO | 

CLQOERYR 00011 l j l t x. » 

CLQOERYR 00013 gives the total number of spool files in the system to te 
CLQOERYR 00014 received by the user who issued the command. 


CLQOERYR 00016 QU ERY READER - Class G 

00018 FILE CLS RECDS ORIGIN DATE TIME NAME TYPE 

00020 spoolid a norec userid ma/dd/yy hh:aa:ss filename filetype 

00023 
00025 
00027 

00029 Only one file will be listed for a QUERY REAIER spoolid 

00030 command. 

CLQUERYR 00034 spoolid a unigue, system assigned number which is used by 
CLQUERYR 00035 VM/370 to identify the file. 

CLQOERYR 00037 norec gives the number of logical records contained in 

CLQOERYR 00038 the file. 

CLQOERYR "0040 userid specifies the identification of tne user whc 

CLQOERYR 00042 originated the file. 


CLQUERYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 

CLQUERYR 

CLQOERYR 

CLQOERYR 


CLQUERYR 00044 am/dd/yy gives the date the file was created in 
CLQUERYR 00045 aonth/day/year. 
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CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQOERYR 


CLQUERYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 

CLQUERYR 

CLQOERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQOERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQOERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQOERYR 


00”47 hh :n» :ss gives the time of file crcaticn in 
Q0048 hours:minutes:seconds, 

00051 filename gives the filename assigned to the file (if any). 

00054 filetype gives the filetype assigned to the file (if any). 


00058 P RINTE R - Class G 


00060 FILE CLS RECDS CPY HOLD DATE TIME kAME TYPE 

00062 spoolid a norec nn hold mm/dd/yy hh:mm:ss filename filetype 
00066 

00068 . . 

00070 

”0071 Only one file mill be listed tor a QUERY FEINTEF spoolid 
00072 command. 


00076 

00077 

spoolid 

a unique, system assigned number khich is used 
VN/370 to identify the file. 

cy 

00080 

a 

the output class of the file. 


00082 

00083 

norec 

gives the number of logical records contained 
the file. 

in 

00085 

00086 

nn 

is the number of copies of the output file to 
produced. 

be 


C0C89 

hold 

is the file 

hold status 

and 

is either 

00091 

00093 

00095 

00097 


NONE - 
USER - 
SIS - 
USIS - 

no hold 
user hold e 

system hold 
system and user 

hold 

00099 

00100 

mm/dd/yy 

gives the date the 

aonth/da y/year. 

file was 


00102 hh:mm:ss gives the time of file creation in 
00103 hours: minutes:seconds. 


00106 filename gives the filename assigned to the file (if auy). 

00109 filetype gives the filetype assigned to the file (if any). 
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CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQOERYR 

CLQOSRYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 


CLQOERYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 

CLQOERYR 


00113 flO££I PUNCH - Class G 

n0115 FILE CLS SECDS CPY HOLD DATE TIME NAME TYEE 

00117 spoolid a norec nn hold mm/dd/yy hh:aa:ss filename filetype 
00121 

00123 . • 

00125 

00127 Only one file will be listed for a QUERY PUNCH spoolid 
00128 conaand. 


00131 spoolid a unique, system assigned number vhicb is used by 
00132 VM/370 to identify the file. 


00135 a 

00138 norec 

00140 nn 

00141 

00144 hold 


the output class of the file. 

gives the number of records in the file. 

specifies the number of copies of the output file 
to be produced. 

is the file hold status and is either: 


00146 

00148 

00150 

00152 


NONE - no hold 

USER - user hold 

SYS — system hold 

USYS - system and user hold 


00154 nm/dd/yy gives the date the file was created in 
00155 month/day/year. 


00157 hh:ma:ss gives the time of file creation in 
00158 hours: minutes:seconds. 


00161 filename gives the filename assigned to the file (if any). 

00164 filetype gives the filetype assigned to the file (if any). 


00170 fiUERJ S£T - Class G 

00172 gives the settings of all functions which are ccntrolled ty 
00173 the SET command. Refer to the discussion of the SET command 

00174 for explanations of the functions. 

00176 {ON ) 

00177 {OFF } 

00178 {ON J {ON} (CODE) {ON } 

00179 MSG {OFF} , WNG {OFF}, EMSG (TEXT), ACNT (OFF} 

00181 {ON } {ON } {ON ) 

00182 LINEDIT (OFF} , TIMER {OFF), RUN {OFF} 
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CLQOBRYR 

00185 

flUEBI TBPWMIi “ class Q 



CLQUERYR 

00189 

gives 

the settings of all functions which are controlled by 

CLQUERYR 

00189 

the 

TERMINAL coaaand. Refer to the 

discussion of 

the 

CLQUERYR 

00191 

TERMINAL command for explanations of the 

functions. 


CLQOERYR 

00193 

LINEND n, LINEDEL n, CHARDEL n, ESCAPE n 



CLQUERYR 

00195 


(ON } (ON } 

(OB } 


CLQOERYR 

00196 

LINESIZE nnn, MASK (OFF), APL {OPFJ # ATTN 

(OFF) 


CLQOERYR 

00199 


VIRTUAL ALL - Class G 



CLQOERYR 

00203 

Has 

the sane effect as if the following commands 

were 

CLQOERYR 

00204 

issued: 



CLQOERYR 

00206 

QUERY 

VIRTUAL STORAGE 



CLQOERYR 

00207 

QUERY 

VIRTUAL LINES 



CLQOERYR 

00208 

QUERY 

VIRTUAL TAPE 



CLQOERYR 

00209 

QUERY 

VIRTUAL UR 



CLQOERYR 

00210 

QUERY 

VIRTUAL DASD 



CLQOERYR 

00213 

m 

VIRTUAL DASD - Class G 



CLQOERYR 

00216 

gives 

the status of each minidisk defined to the user's 

CLQOERYR 

00217 

system. 



CLQOERYR 

00219 


(H/H) 



CLQOERYR 

00220 

DASD 

vaddr type volser (B/O) nnn CYL 



CLQOERYR 

00227 

vaddr 

gives the virtual address to which the DASD device 

CLQOERYR 

00228 


is attached. 



CLQOERYR 

00231 

type 

» 2311 



CLQOERYR 

00232 


2305 



CLQOERYR 

00233 


2314 



CLQOERYR 

00234 


3330 



CLQOERYR 

00235 


231T (2311 at top of 2314) 



CLQOERYR 

00236 


23IB (2311 at bottoa of 2314) 



CLQOERYR 

00241 

volser gives the voluae serial nuaber 

of the systea 

disk 

CLQOERYR 

00242 


on which this minidisk resides. 



CLQOERYR 

00246 

R/N 

defines the type of access 

the user has 

to 

CLQOERYR 

00248 

R/O 

the disk. 



CLQOERYR 

00253 

nnn 

gives the nuaber of cylinders on tie ainidisk. 
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CLQUEBTB 00257 i2H£BI VIRTU AL “ Class G 

CLQUERYR 00258 gives status of all communication lines defined to the 

CLQUERYR 00259 user's virtual machine. 

CLQUERYR 00261 LINE vaddr ON DEV raddr 

CLQUERYR 00264 vaddr the virtual address to which the lin is attached. 

CLQUERYR 00267 raddr the real address of the line. 


CLQUERYR 00272 {ENABLED } 

CLQUERYR 00274 LINE vaddr (DISABLED) 

CLQUERYR 00276 gives the status of virtual communication lines. 


CLQUERYR 00281 fiUERI IHI24L UR - Class G 

CLQUERYR 00283 gives the status of all virtual unit record devices aitacned 

CLQUERYR 00284 to the user's virtual machine. 

CLQUERYR 00286 RDR vaddr CLS a 

CLQUERYR 00288 {PUN} vaddr CLS a COPY nn 

CLQUERYR 00290 (PRT) 

CLQUERYR 00292 vaddr the virtual address at which the device is 
CLQUERYR 00293 located. 


CLQUERYR 00296 a the output class which the device services. 

CLQUERYR 00298 nn the number of copies of each output file to be 

CLQUERYR 00299 produced. 


CLQUERYR 00303 QUER Y VIRTUA L STORAGE - Class G 
CLQUERYR 00305 STORAGE = nnnnnK 

CLQUERYR 00306 gives the size of the virtual machine in multiples of 1024 
CLQUERYR 00307 bytes. 


CLQUERYR 00310 fiUERI VIRTUA L v&Ml - Class G 

CLQUERYR 00312 The response will be in the same form as QUERY VIRTUAL EASE, 

CLQUERYR 00314 TAPES, LINES, or UR, depending on virtual device type. 
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CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 

CLQUERYR 


00317 asm itiMS iams . 

00319 gives a list of users who have linked to the device at virtual address vaddr. 

00321 userid (R) vaddr, ... 

00323 . {11} 

00325 . . 

00327 

00329 userid (R) vaddr, ... 

00330 (H) 

00335 userid identification of the user vho originated the 

00336 link, 

00339 R the type of access the user has to the device. 

00342 V 

00345 vaddr the virtual address by which the user (userid) 

00346 refers to the device. 
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CLREADY 

0000 * 

CLREADY 

00007 


CLREADY 

00C09 

CLREADY 

00010 

CLREADY 

00011 

CLREADY 

00013 


CLREADY 

00C20 

CLREADY 

00021 

CLREADY 

00C22 

CLREADY 

00023 

CLREADY 

00028 


mei 


ElililSH® Class: G 


The READY conaand sets a device-end interrupt pending in the 
specified virtual device. The status of the virtual aachine 
is unchanged. Other than having a device-end interrupt 
pending, the virtual device is unchanged. 


r—- i 

| READY | vaddr | 
I i I 


L 


.£ 


vaddr specifies a virtual device address (ecu). 


CLBEADY 00030 Resp onses 

CLREADY 00032 None. 
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CLREPEAT 00003 MZZA1 


CLBEPEAT 00006 Pr ivile ge D 


CLREPEAT 00^10 The REPEAT command: 

CLREPEAT 00014 1. increases the number of copies of an output tile 

CLREPEAT 00015 originally reguested by the filers creator. 

CLREPEAT 00018 2. places the current output file in a HCLD status, with 

clrepeat 000 18 or without increasing the nuaber of copies to te 

CLREPEAT 00019 created. 

CLREPEAT 00021 This coaaand applies to files currently being written tc a 
CLREPEAT 00023 real punch or printer. 


CLREPEAT 00032 
CLREPEAT 00033 
CLREPEAT 00034 
CLREPEAT 00035 
CLREPEAT 00036 
CLREPEAT 00037 
CLREPEAT 00038 
CLREPEAT 00039 
CLREPEAT 00040 
CLREPEAT 00041 
CLREPEAT 00042 
CLREPEAT 00043 

CLREPEAT 00049 
CLREPEAT 00050 
CLREPEAT 00051 

CLREPEAT 00053 
CLREPEAT 00054 
CLREPEAT 00055 
CLREPEAT 00057 
CLREPEAT 00058 

CLREPEAT 00061 
CLREPEAT 00062 
CLREPEAT 00063 
CLREPEAT 00064 
CLREPEAT 00065 
CLREPEAT 00066 
CLREPEAT 00067 
CLHEPEAT 00068 
CLREPEAT 00069 


34 2 



REPEAT 


r 

V 



REP 

1 

i r i 

1 




1 

) 1 nn J 

1 




1 

i ii 1 

1 





1 L J 

1 




| raddr 

1 r t 

1 




5 

1 1 nn | 

HOLD | 




1 

1 10 | 

1 




1 

1 L J 





« 

L 

J 



specifies the address of the cutout device 
(printer or punch) whose current active spoci file 
is to be repeated or held. 

specifies the number of extra copies of the 
current file that are to he made. If on is caitted 
and the HOLD option is not specified, the nuaber 
of extra copies defaults to 1. The naxivua value 
which nay be specified for nn is 95. 

specifies that the file currently being printed or 
punched is not to be deleted when writing of the 
file is coaplete. If nn is not specified and this 
option is specified, when the last copy has 
completed, the file will be placed in system HCLD 
status until it is explicitly released. 

Note: All copies indicated by a SICCL coaaand or 
by a previous REPEAT coaaand will be printed 
before the HOLD option takes effect. 
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CLBEPBAT 

00073 

BS§E2J15SS 






CLREPEAT 

00075 

type raddr REPEATED userid FILE= 

spoolid 

COPY 

= nn 

CLREPBAT 

00077 

type 

either PRT or PUN. 





CLREPEAT 

CLREPEAT 

00079 

00081 

raddr 

the real address of the 
output is being repeated. 

device 

whcse current 

CLREPEAT 

CLREPEAT 

00084 

00085 

userid 

the identification of 
the output. 

the 

user 

vhc 

is tc receive 

CLREPEAT 

CLREPEAT 

00088 

00089 

spoolid 

a unique, systea assigned 
refers to the file. 

nunber ty 

khicfa VM/370 

CLREPEAT 

CLREPBAT 

00091 

00092 

an 

the regaining number 
created. 

of copies 

of the file to be 
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CLRESET 

00003 

IBSBI 





CLBESET 

00006 

Ediilaaa £la§s: g 





CLRESET 

00008 

The RESET connand clears 

all 

. pending 

interrupts frea the 

CLRESET 

00009 

specified virtual device. 

In 

addition. 

all error conditions 

CLRESET 

00010 

occurring as a result 

of 

unit 

checks and 

virtual sense bytes 

CLRESET 

oooii 

are reset. 





CLRESBT 

00018 

i"'~" 1 ■ 


— i 



CLRESET 

00019 

| RESET | vaddr 


1 



CLRESET 

00020 

» ... 





CLRESET 

00026 

vaddr specifies a 

virtual 

device address (ecu). 

CLBESET 

00028 

fiespojisss 





CLREMIND 

00001 

DEVICE BESET 
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CLREHIND 00004 fiEHlifi 


CLREHIND 00007 flivilsae C^ass: G 


CLREHIND 00008 The BEHIND coaaand allows the user to rewind a real tape 
CLBEHIND 00009 drive attached to his virtual nachine at a specific virtual 
CLREHIND 00010 device address. This allows the user to acccaplish the 
CLREHIND 00011 nanual operation of rewinding and readying a tape at the 
CLREHIND 00012 tape drive. 


CLREHIND 00019 ,--, 

CLREHIND 00020 | REWIND | vaddr I 

CLREHIND 00021 } 8EW j J 

CLREHIND 00022 «---• # - 

CLREHIND 00027 vaddr specifies the virtual device address (ecu) of the 
CLREHIND 00028 tape to be rewound. 


CLBEHIND 00032 Resp o nses 


CLREHIND 00034 REWIND COMPLETE 


CLREHIND 00036 REWIND NOT PEBFORMED 

CLREHIND 00037 is the response to the user if the real taps device is net 
CLSAVSYS 00001 ready. 
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CLSAYSYS 

00004 

SAIISIS 


CLSAVSYS 

00007 

Cidgs: E 

CLSAVSYS 

CLSAVSYS 

CLSAVSYS 

00009 

00010 

00C11 

The SAVESYS command allows the system analyst tc save a 
victual machine storage space with registers and ESW teing 
saved as they currently exist. 

CLSAVSYS 

CLSAVSYS 

CLSAVSYS 

00018 

00019 

00020 



| SAVESYS 

* .- - 

| systea-naae I 

„ ■ - .~ n * 



CLSAVSYS 

CLSAVSYS 

CLSAVSYS 

CLSAVSYS 

CLSAVSYS 

CLSAVSYS 

CLSAVSYS 

CLSAVSYS 

CLSAVSYS 

CLSAVSYS 

00027 

00027 

"0028 

00029 

00029 

00C31 

00032 

00033 

00034 

00035 

systea-naae 

must be a pre-defined name representing a 
definition of installation requirements cf 
the naaed system. The definition indicates 
the nuaber of pages tc be saved, the DASD 
voluae on which the system is to fce saved, 
and the shared segaents (if any) . Refer tc 
the 1J3JJ Viytgal Hac nine F acilit y/37Q, 

Planning agd System Generation Guide (Order 
No. GC20-1801) for further information 

concerning system definition. 

CLSAVSYS 

00038 

issEansa 


CLSETP 

00001 

SYSTEH SAVED 
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00005 

££1 





CLSETP 

00008 

Etililege C^ass: A 

, B, F, G 




CLSETP 

00010 

The SET command 

allows the operator 

to 

establish 

system 

CLSETP 

00010 

parameters, and 

the virtual user 

to 

ccntrcl 

various 

CLSETP 

00012 

functions within 

his virtual system. 

The 

SET commands are 

CLSETP 

00013 

used as described 

to perform various 

functions available to 

CLSETP 

00014 

users with specific privilege classes to 

control 

the CP 

CLSETP 

00015 

system and virtual 

nachine options. 




CLSETP 

00026 

CLASS Ax 






CLSETP 00028 
CLSETP C 0029 
CLSETP 00030 
CLSETP 00031 
CLSETP 00032 
CLSETP 00033 
CLSETP 00034 
CLSETP 00035 
CLSETP 00036 
CLSETP 00037 
CLSETP 00038 
CLSETP 00039 
CLSETP 00040 


FAVORED The FAVORED function can be in effect for only 

FAT one virtual nachine at any tine. If xx (a 

percentage from 1-99 with 1 being the highest), is 
specified, VM/370 will attempt tc provide up to 
the specified percentage of CPU time tc that 
virtual aachine, provided that virtual machine is 
functioning so that it can fully utilize the CPU 
tine. At regular tine intervals the VM/370 
dispatcher will check the CPU tine used by the 
particular virtual nachine; if the percentage nas 
been exceeded, the machine is net run tor the 
remainder of the interval. If the percentage is 
low, the virtual machine will have highest 

priority for the remainder of the interval. 

If OFF is specified, the specified virtual machine 
is removed from FAVORED status. 

CLSETP 00061 If neither OFF nor xx is specified, the virtual 

CLSETP 00062 nachine designated will always be dispatchable; 

CLSETP. 00063 that is, any time he is ready to tse CPU time, he 

CLSETP 00C64 will be given the highest priority. 

CLSETP 00067 RESERVE allows the specified virtual nachine tc use the 


CLSETP 00047 
CLSETP 00048 
CLSETP 00049 
CLSETP "0050 
CLSETP 00051 
CLSETP 00051 
CLSETP 00052 
CLSETP 00053 
CLSETP 00053 
CLSETP 0CC54 
CLSETP 00055 
CLSETP 00056 
CLSETP 00056 
CLSETP 00058 

CLSETP 00059 
CLSETP 00060 


«- 

1 



f -j 

- , 

SET 

1 ( 

FAVORED 

userid 

|xx | 

i i 

S 

1 { 



J OFF | 

) 1 


1 ( 



L J 

} 1 


1 ( 




} 1 


1 ( 

RESERVE 

userid 

(XX ) 

} 1 


1 ( 



(OFF) 

} i 


1 ( 




J 1 


1 ( 

PAGING 

nn 


) f 


1 l 




1 1 

_ 

9 ( 

PRIORITY 

userid 

nn 

} 1 
-1 
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CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 


CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 


00068 
00069 
00070 
90 ft 71 
00071 
00073 

RES 

specified number of page frames for its exclusive 
use. The page frames are not "locked*' and tne 
virtual machine can also use other available page 
frames; however# no other virtual machine can use 
a reserved page frame unless all page frames 
available have been exhausted. 

00076 

00076 

00077 

XX 

specifies the number or page frames reserved. 
Maximum number is limited by tte size cf the 
virtual machine. 

00080 

90081 

OFF 

removes the user from Reserve tage Status and 
returns the reserved pages tc the system. 

0 0084 
00086 
00087 
00088 
00089 

PAGING 

PAG 

alters, the system paging activity index tc the 
specified value (nn). This value affects the 
paging rate and degree of multiprogramming used. 
The current value of this index may be displayed 
by the QUERY command. 

00094 

00096 

00097 

00098 

PRIORITY 

PRIOR 

sets the specified user's (userid) priority tc the 
desired value (nu). This value affects the user's 
dispatching priority in relation tc otter users in 
the system. 


CO 104 


CLASS b: 


"0106 


00107 


1 ( 


r t 

) 1 

00108 

| SET 

I { 

LOGMSG 

inn | 

i i 

00109 


1 ( 


|NULL) 

J 1 

00110 

1 

i l 


L J 

) 1 

0 0111 

1 

1 { 


r i 

} 1 

00112 

1 

1 ( 

DUMP 

(AUTO } ) CP 

i 1 

00113 

1 

1 ( 


(raddr) |ALL | 

) 1 

00114 

1 

8 ( 


L J 

} 1 

00115 

00119 

■ 



_1 

LOGMSG 


LOGMSG 

or LOGMSG nn causes CP 

00121 

LOG 


message 

LOGMSG:# followed by 


00122 
00123 
0 0124 
00124 
00127 
00129 
O0129 
00131 
00132 


operator to enter the lin 
parameter is used to initiali 
message. LOGMSG nn specifies 
be made to existing line nu 
message. A null line entere 
entry (for adding or initializ 
nn if that option is used, 
the entire existing LOGMSG# a 
to be created. 


to respond w 
read tc en 
e. ICGMSG 
ze cr add t 
that a cnan 
nber on in 
d terminates 
ing) cr dele 
LOGMSG NULL 
Hawing a ne 


ith the 
able the 


with 
o a 


no 

leg 


ge xs to 
the leg 
LCGMSG 
tes lice 
deletes 
W LCGMSG 


00135 DUMP DUMP sets the VM/373 system ABEND dump unit# where 
00137 DU raddr is a real printer or tape address, Ii AU1C 
00138 is specified the system dump unit will oe distc. 
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CLSETP 

CLSETP 
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CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 


CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 

CLSETP 


CO 139 
00140 
00141 


The CP option specifies to dump only 
occupied by the control program, whereas 
option dumps all storage. 


storage 
the ALL 


00147 CLASS F: 


00150 


0C151 

r~ 

1 

SET | 

{OF P 



•"1 
} i 

00152 

1 

1 

{CPU 



i i 

00153 

1 

1 

RECORD { 

r 

T 

i i 

00154 


1 

(ON raddr LIMIT nn BYTE an BIT n 

1 {AND} 

BYTE nn BIT n| 

i i 

00155 

1 

1 

C 

! {OB } 

1 

} i 

00156 

I 

J 

{ 

L 

j 

i i 

00157 






_j 


00161 
00163 
00164 
00165 
00166 
00167 
00168 
C0169 
C 0 169 
00170 
00171 
00172 
00173 


BECOHD 

BBC 


ON allows the Class F user to specify intensive 
recording mode for the device 'raddr'. LIMIT 
identifies the value at which a recording will be 
made, and the BYTE and BIT operands define the 
t9st condition in the sense bytes. Twc bits may 
be tested by an AND or OB relationship. The OFF 
function turns off intensive recording mode. Only 
one device at a tine may have intensive recording 
specified. The CPU operand specifies that CP is 
to resume the recording of "soft" machine errors 
previously turned off by VB/370 recovery 
management system procedures due to excessive 
occurrences. 


00177 CLASS G: 


'.’U I t'i f— 

00180 J 

SET J{{ACNT ) 

{ON } }1 

0O181 | 

| { {MSG } 

{OFF} } | 

00182 | 

| { (WNG } 

} t 

00183 | 

{{{RUN } 

} ! 

00184 j 

|{{LINEDIT} 

} 1 

00185 | 

| {(NOTBANS) 

H 

00186 | 

1 ( 

} t 

00187 | 

j { EMSG 

{ON }}| 

00188 | 

1 ( 

{OFF }}| 

00189 | 

1 ( 

{CODE}} | 

00190 | 

1 ( 

{TEXT} } J 

00191 | 

1 { 

} I 

00192 | 

| { TIMES 

{ON }}| 

00193 | 

I ( 

{OFF }}| 

00194 j 

1 ( 

{REAL}} | 

00195 *— 


-_J 


n 02C1 ACNT controls whether accounting infcrmafion 

fl 0203 AC at the user's terminal or not (CN 


is typed 
and CFF 
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00204 

CLSETP 

00205 

CLSETP 

00208 

CLSETP 

00209 

CLSETP 

00211 

CLSETP 

00211 

CLSETP 

00212 

CLSETP 

00215 

CLSETP 

00217 

CLSETP 

00218 

CLSETP 

00219 

CLSETP 

00222 

CLSETP 

0 0224 

CLSETP 

00225 

CLSETP 

00226 

CLSETP 

00227 

CLSETP 

00228 

CLSETP 

00229 

CLSETP 

00234 

CLSETP 

00235 

CLSETP 

00236 

CLSETP 

00237 

CLSETP 

00238 

CLSETP 

00239 

CLSETP 

00240 

CLSETP 

00241 

CLSETP 

00241 

CLSETP 

^0242 

CLSETP 

00245 

CLSETP 

00247 

CLSETP 

00247 

CLSETP 

00249 

CLSETP 

00252 

CLSETP 

00253 

CLSETP 

0 0254 

CLSETP 

00255 

CLSETP 

00256 

CLSETP 

00257 

CLSETP 

00260 

CLSETP 

00261 

CLSETP 

00262 

CLSETP 

00263 

CLSETP 

00264 

CLSETP 

00265 



raapecti 

command. 

vely) when 

the operator 

issues 

the 

CP 

AC NT 

MSG 

controls 

whether messages sent 

by the 

MSG 

com 

mand 

H 

from ot 

her users 

are to be 

receiv 

ed 

a t 

the 


terminal. If ON is specified, the messages are 
typed. OPF specifies that no aessages are 
received. 


HNG If ON is specified, all warning messages sent via 

W the CP HNG command from other users are received 

at the terainal. If OFF is specified, nc warning 
messages are received. 

RON ON allows the user to activate the ATTK *ey, 

R (causing a read of a CP command) without stopping 

his virtual machine. When the CP function is 
typed in, it is immediately executed and the 
virtual machine resumes execution. OFF places the 
user in the normal CP environment, sc that when 
ATTN is activated, the virtual machine steps. 


LINEDIT ON specifies that the line editing functions and 
L the symbols of the Vfl/370 system are tc be used in 

the virtual machine operating system to edit 
virtual CPU console input reguests. This 
establishes line editing features in systems that 
do not normally provide them. OFF specifies that 
no character or line editing is to be used for the 
virtual machine operating system. See "Appendix 
B: Terminal Considerations" for a description of 
VM/370 Line Editing Capabilities. 


NOTRANS can only be specified by a virtual machine that 

NOTR occupies the virt=real space. It causes all 

virtual I/O from the issuing virtual machine to 
bypass the CP CCW translation. 

EHSG ON specifies that, when the user receives an error 

E message, he will get both error cede and text. 

TEXT specifies that only text be printed. CODE 
specifies that only the error cede be printed. 
OFF specifies that no error message is to be 
printed. 


TIMER OFF specifies that the virtual timer is net tc be 

T updated. ON specifies that the virtual timer is 

to be be updated only when the virtual CPU is 
s ruuning. REAL specifies that the virtual timer is 

to be updated during virtual CPU run tiie and also 

virtual wait time. 
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00269 

00001 


None. 
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CLSHUTDN 


CLSBOTDN 


CLSHOTDN 

CLSHUTDN 

CLSHOTDN 

CLSHOTDN 

CLSHOTDN 

CLSHOTDN 

CLSHOTDN 

CLSHOTDN 


CLSHOTDN 


CLSHOTDN 

CLSLESP 


00005 

saiufiowN 


00008 

fciliieae Cl^gs: A 


00009 
00011 
000 12 
r*091 3 
00015 

The SHUTDOWN coaaand systematically terminates all VM/370 
functions and checkpoints the systea foe an eventual warn 
start. This is the normal method used fer shitting the 
system down. All VM/370 functions are suspended and 

coaaunications lines are disabled. 

00022 

00023 

00024 

r - i 

| SHUTDOWN | j 

<— — .. -.. , i 


00029 

Response 


00031 

The operator is notified of command completion 

by: 

00001 

SYSTEM SHUTDOWN COMPLETE 
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CLSLEEP 


CLSLEEP 

CLSLEEP 

CLSLEEP 

CLSLEEP 

CLSLEEP 

CLSLEEP 

CLSLEEP 

CLSLEEP 

CLSLEEP 

CLSLEEP 

CLSLEEP 


CLSLEEP 


CLSPACE 


00005 

2L£££ 


00008 

PEililSas Class: 

ALL 

00009 

0C010 

00011 

00011 

00012 

00013 

00015 

The SLEEP command places the virtual machire in a dormant 
state with the keyboard locked, but allows messages tc be 
printed out without the user signaling a carriage return. 
The user 9 s virtual machine is not run during this time, but 
his connect time is still being counted. The terminal can 
be "awakened* by pressing the ATTN key (or its equivalent). 
This returns the user to CP console function mede. 

00022 

0 9C23 
00024 
00025 



1 SLEEP | 

\ SL J 

« .. .. . 

1 

} 

1 

A 



00029 

fiSSE2B£&S 


00001 

Rone. 
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CLSPACE 00005 SPACE 


CLSPACB 00008 Privi lege Sla^s: D 


CLSPACE C0C09 The SPACE coaaand forces the output on the sfeciticd printer 
CLSPACE 00010 to be single-spaced for the current active sped file, 
CLSPACE 00C11 regardless of the carriage control commands contained in the 
CLSPACE 00C12 actual file. 

CLSPACE 00C19 ,- 

CLSPACE 00020 | SPACE | raddr | 

CLSPACE 00021 | SPA | | 

CLSPACE 00^22 «-J 

CLSPACE 00028 raddr is the real address (ecu) of the printer whose 
CLSPACE 00030 output is to be single spaced. 


CLSPACE 00033 Respo nses 


CLSPOOL 00001 None. 
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CLSPOOL 

00005 

CLSPOOL 

00008 


CLSPOOL 

00099 

CLSPOOL 

00010 

CLSPOOL 

00011 

CLSPOOL 

00022 

CLSPOOL 

00023 

CLSPOOL 

00024 

CLSPOOL 

00025 

CLSPOOL 

00026 

CLSPOOL 

00027 

CLSPOOL 

000 28 

CLSPOOL 

00029 

CLSPOOL 

00030 

CLSPOOL 

00031 

CLSPOOL 

00C32 

CLSPOOL 

00039 

CLSPOOL 

00040 

CLSPOOL 

00041 

CLSPOOL 

00042 

CLSPOOL 

00C44 

CLSPOOL 

00045 

CLSPOOL 

00047 

CLSPOOL 

00050 

CLSPOOL 

00052 

CLSPOOL 

00954 

CLSPOOL 

00056 

CLSPOOL 

00058 

CLSPOOL 

90060 

CLSPOOL 

09 n 62 

CLSPOOL 

00064 

CLSPOOL 

00066 

CLSPOOL 

00068 

CLSPOOL 

0096 9 

CLSPOOL 

00071 

CLSPOOL 

O 9072 

CLSPOOL 

00973 

CLSPOOL 

00074 

CLSPOOL 

09076 

CLSPOOL 

O0077 

CLSPOOL 

9 0078 

CLSPOOL 

00079 




Etllileae Cl,ass: G 


The SPOOL comnand modifies the spooling contrcl cftions in 
effect for a given virtual spooling device or for a group of 
devices. 


1 

l 


r 

i 

r 

n r t 

i 

SPOOL i (READER) 

((CLASS 

a] ) CONT 1 

| HO ID i | EOF | 

} * 

SP | (vaddr } 

( 


|NOCONT| 

JNOHCICI |NCEOF| 

i 

1 

( 


L 

j 

t 

j i j 

} 

8 

i 

( 

r 

t 

r 

T 

r i 


| (PRINTER) 

( 

|(TO] 

userid | 

) HOLD | 

| CCNl | 


1 (PUNCH ) 

( 

I OFF 

1 

| NOHOLD| 

) NOCG NT f [CLASS a] (COE* nn ] 

| (vaddr ) 

l 

L 

j 

i 

J 

i J 



* at least one of the options within traces gmst be 
selected; however, more than one say be specified and they 
say be entered in any order. This is contrary to the 
notation normally used in this publication. 

vaddr is the device address (ecu) cf the virtual 

spooling unit record device whose options are to 
be nodified. 

BEADED indicates that the function is to fce applied to 
R all virtual devices of the specified type. 

RDR 


PRINTER 

P 

PST 

PUNCH 

PU 

PCH 

CONT for virtual readers, this specifies that reading 

CON be continuous with all end-of-file indicators 

being ignored until all files spooled to the 
virtual machine are read in. If this option is 
not in effect, a unit exception is reflected to 
the user's virtual machine at the end of each 
spooled file. CONT specified for the punch or 
printer causes all CLOSE requests to be ignored, 
until reset by NOCONT. If CONT is specified, 
NOCONT may not be specified 
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C LS POOL 
CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 

CLSPOOL 


non 82 

NO CONT 

00084 

NOC 

00087 

COPY nn 

00^89 

CO 

00090 


00090 


0 r 09 1 


00094 

CLASS a 

90096 

CL 

00096 


00097 


00098 


O 0101 

HOLD 

0 f )102 

HO 

00103 


09104 


99104 


O0105 


09106 


99109 

NO HOLD 

09110 

NOH 

09112 


09113 


09115 


00116 


09119 

EOP 

00120 


O 0121 


00122 


o 0123 


00124 


00127 

NOEOF 

00129 

NOE 

00130 


00131 


00132 


00135 

TO user: 

00136 

T 

00137 


00138 


00139 


00139 


00141 


00141 


00142 


00143 


00 144 



resets the continuous spooling option. If NCCCNT 
is specified, CONT nay not be specified. 


specifies the number of copies that are tc be made 
of the file when it is spooled tc the real unit 
record equipnent. This parameter is valid cnly 
for output files; nn must be between 1 and 99; 
leading zeroes need not be specified. 


specifies the class that is to be assigned tc the 
given device. For input files, ocly devices with 
classes matching those of the device will be read. 
A is a one-character alphameric field with values 
from A to Z or from 0-9. 

specifies that all output files created by the 
specified device are to be placed in a user HOLD 
status. For READER files, this opticr specifies 
that input files for the specified reader will not 
be deleted from the system after they have been 
read. If HOLD is specified, NOHCID nay not be 
specified. 

resets the HOLD option. Future files will not te 
held. MOHOLD resets the HOLD opticn in effect fcr 
the specified reader. This cpticn can te 
overridden for the active file beirg closed by the 
CLOSE command using the HOLD or NCHOLC option. If 
NOHOLD is specified, HOLD may not be specified. 


indicates that the virtua 
the specified reader has 
ensuring that a unit exce 
reflected on the read that 
the last card in a file 
NOEOF may not be specified 


1 

end- 

of 

-file 

fc 

ut ton 

c 

n 


been 

F 

resse d 

t 

t he reb 

Y 

Pt 

io n 

cc 

rditic 

n 

will 

t 

e 

follow 

s the 

re 

ading 

c 

f 

. 

If 

EO 

F is 

£ F 

ecif ied 

r 


specifies that the reading continues to physical 
end-of-file. The virtual reader will step with rc 
cards left in the reader and with a unit 
check/intervention required states pending. It 
NOEOF is specified EOF may not be specified. 


specifies that the output of the virtual spooling 
device is to be transferred to the virtual card 
reader of the specified userid. If TO is emitted, 
userid may not be TO or T. TO * may te coded if 
the output is to be transferrad tc the virtual 
card reader of the user issuing the command. If TO 
userid is specified, OFF may not be specified. 
HOLD and COPY have no effect in a transfer of 
files if TO userid is specified. Hcwever, if they 
are specified with TO userid, and the TO userid 
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CLSPOOL 

00145 

CLSPOOL 

00146 

CLSPOOL 

00147 

CLSPOOL 

00148 

CLSPOOL 

00150 

CLSPOOL 

00151 

CLSPOOL 

00153 

CLSPOOL 

00155 

CLSPOOL 

00156 

CLSPOOL 

00157 

CLSPOOL 

00159 

CLSPOOL 

00162 

CLSPOOL 

00164 

CLSPOOL 

00165 

CLSPOOL 

00166 

CLSPOOL 

00167 

CLSPOOL 

00167 

CLSPOOL 

00168 

CLSPOOL 

00169 

CLSPOOL 

00170 

CLSPOOL 

00171 

CLSPOOL 

00171 

CLSPOOL 

00172 

CLSPOOL 

00173 

CLSPOOL 

00175 


CLSPOOL 

00177 

CLSTABTP 

00001 


specification is subsequently cancelled by issuiny 
a SPOOL command with the OFF specification, they 
will be in effect. Foe example, if the fallowing 
coaaand is entered: 

SPOOL PUN TO usera COPY 3 CLASS B ECLD 

the COPY and BOLD options will have no effect. If 
the coanand: 

SPOOL PUN OFF 

is then entered, the options specified in the 
previous SPOOL PUN coanand will be in effect; that 
is, COPY 3 and HOLD will now be in effect. 

OFF resets the transferred sped option. 

CONT specifies that reading is to ccntinue without 
intervening end-of-file indications until ail files in the 
system that belong to the user have been read. If CONT is 
not in effect or is reset by specification cf NCCONT, an 
end-of-file indication is reflected to the virtual machine 
at the end of each SPOOL file in the systea. The nature of 
the end-of-file indication to be reflected is set by the 
EOF|NOEOF option. If the EOF option is in effect, 
end-of-file is signaled by a unit exception. This 
corresponds to pressing the end-of-file button cn a real 
card reader. If the virtual EOF button is net pressed (that 
is, NOEOF is in effect), end-of-file is signaled by the 
reflection of a unit check/intervention required status. 


fasEgasgs 

None. 
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CLSTARTP 00005 


SIAIZ 


CLSTARTP 00008 


Elillle^e Sluss: D 


CLSTARTP 

CLSTARTP 

CLSTARTP 

CLSTARTP 

CLSTARTP 

f T A RTP 

00009 

00010 

00011 

00012 

0O013 

00024 

The START coaaand restarts a spooling device after it has 
been drained, or changes the output class that it aay 
service. If the device is busy when the coaaand is given, 
the changed classes take effect after the current file is 
coaplete. 

^ i /V I\ i c 

i- 


-1 

CLSTARTP 

00025 

I START | r 


1 1 

CLSTARTP 

00026 

1 STA || 

READER 

1 1 

CLSTARTP 

00027 

I 1 1 

PRINTER 

1 1 

CLSTARTP 

00028 

1 I 9 

PUNCH 4 

1 1 

CLSTARTP 

00029 

1 1 1 

AJtL 

1 1 

CLSTARTP 

00030 

1 1 1 


1 1 

CLSTARTP 

00031 

1 i 1 

[ raddr [CLASS c ] [NOSEPJJ... 

1 1 

CLSTARTP 

00032 

1 1 1 


1 1 

CLSTARTP 

00033 

I 1 L 


j | 

CLSTARTP 

00034 

A 


_8 




CLSTARTP 

00040 

READER 

specifies the type of spooling 

devices(s). If 

CLSTARTP 

00042 

R 

ALL is specified, all spooling 

devices will be 

CLSTARTP 

00044 

RDR 

started. 


CLSTARTP 

00046 

PRINTER 



CLSTARTP 

00048 

P 



CLSTARTP 

00050 

PRT 



CLSTARTP 

00052 

PUNCH 



CLSTARTP 

00054 

PU 



CLSTARTP 

00056 

PCH 



CLSTARTP 

00058 

ALL 




CLSTARTP 00060 radar 
CLSTARTP n 0062 
CLSTARTP 00063 


CLSTARTP 00066 CLASS 

CLSTARTP 00068 CL 

CLSTARTP 00068 
CLSTARTP 00069 
CLSTARTP 00070 
CLSTARTP 00070 
CLSTARTP 00071 
CLSTARTP 00072 


specifies the address (ecu) of a particular 
spooling device which is to be started. More 
than one device aay be specified. 

» 

specifies the output classes the specified 
device is allowed to service. frem one to tour 
classes (single characters with nc intervening 
blanks) aay be specified. If aultiple classes 
are specified for a device, output files receive 
service by the device in the erder that the 
classes were specified. For exaaple, if the 
option: 


CLSTARTP 00C74 


CLASS ADI 


CLSTARTP 00076 


is specified for a printer, all Class A files 
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CLSTARTP 

CLSTARTP 

CLSTARTP 

CLSTARTP 

CLSTARTP 

CLSTARTP 

CLSTARTP 

CLSTARTP 

CLSTARTP 

CLSTARTP 

CLSTARTP 

CLSTARTP 

CLSTARTP 

CLSTARTP 

CLSTARTP 

CLSTARTP 

CLSTARTP 


CLSTARTP 


CLSTARTP 

CLSTARTP 

CLSTARTP 

CLSTARTP 

CLSTARTP 

CLSTARTP 


00C77 
00078 

00081 NOSEP 

00083 NOS 

00084 

00086 
00087 
00088 

00090 

00091 
00092 
00093 

00095 Note: 

00096 files 

00097 producing output when the START coaaand is given. Readers, 

00098 however, will not start until a card deck is supplied and 


0C099 

the 

device is aade ready. 


00103 

Responses 


00107 

type 

raddr SPOOL CLS [a... ] 

STARTED 

00109 

00110 

00111 

type 

one of the following: 

RDR 

PRT 

PUN 

00115 

00116 

a 

(for PRT and PUN only) indicates the classes to be 
serviced by the output spooling device teing started. 


will be spooled before Class D files, and all 
Class D before Class 1. 

specifies that no file separator is desired fcr 
the output files. If not specified, a separator 
is produced. 

If NOSEP is specified for the punch, separator 
cards are not punched; instead, the operator 
receives the message: 

PUN raddr START FOR OUTPUT 

The punch can then be started for the next file 
by a CP START coaaand or physical activation cf 
the START/STOP key on the device. 

Printers and punches that are in a ready status with 
available for processing will iasediately start 
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CLSTCP 


CLSTCP 


CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 

CLSTCP 


CLSTCP 


CLSTORE 


00005 


SISE 


00008 




00009 

00011 

00012 

00023 

00024 

00025 

00026 

00C27 

00028 


00046 

00048 

00049 

00050 

00050 

00051 

00053 

00056 

00056 

00057 

00057 

00059 

00061 

00063 


The STCP command allows alteration of the contents cf real 
storage by system programmers. Tne real PSW or rear 
registers may not be altered with this command. 


1 — 

| STCP | ({ hexloc} 

hexwordl [hexword2.. 

. Ji 

| | ({Lhexlocj 


} 

1 I ( 


) 

| | (Shexloc 

i_ 

hexdata 

} 


00034 hexloc specifies that the data giver ic 

00036 Lhexlcc hexvord2... is to be stored in successive 

00037 locations starting at the address speci 

00038 hexloc. The smallest group of hexadecima 

00038 that can be stored using this specificatic 

00039. fuilword. Alignment is made tc the 

00040 fuilword boundary. If the value being s 

00041 less than ,a fuilword (eight nexacecisai 

00041 it is right-adjusted in the word and t 

00043 order bytes of the word are filled with 

00043 Either specification (nexloc or lhexlcc) 

00044 used. 


h e x w c r .) 1 
rullwcri 
f i e a t y 
1 values 
n is cue 
nea Lest 
tored is 
digits), 
be nign 
zcrcs. 
may Le 


Shexloc 


hexword 


hexdata 


specifies that the data given in bexdata is tc be 
stored in the address specified by hexlcc without 
word alignment. The shortest string that can re 
stored is one byte (two hexadecitrai digits). Ir 
the string contains an ood number cf characters, 
the last character is not stored. An errcr 
message is sent and the function is taiainatea. 

specifies up to eight nexadecimal cigits. It less 
than eight digits are specified, the string is 
right justified in a fuilword and left-filled with 
zeroes. If two or more hexwords are civen, tney 
must be separated by one or more blames. 


specifies a string of two or mere 
digits with no embedded blanks. 


nexadeciaai 


00066 Resp onse 

90001 STORE COMPLETE 
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CLSTOBE 


CLSTOBB 


CLSTOBE 

CLSTOBE 

CLSTORE 

CLSTOBE 

CLSTOBE 

CLSTOBB 

CLSTOBE 

CLSTORE 

CLSTOBE 

CLSTOBE 

CLSTORE 

CLSTOBE 

CLSTORE 

CLSTOBE 

CLSTOBB 

CLSTOBB 

CLSTOBE 

CLSTORE 

CLSTOBE 

CLSTOBB 

CLSTOBE 

CLSTOBE 

CLSTOBB 

CLSTORE 

CLSTOBE 

CLSTOBE 

CLSTOBE 

CLSTORE 

CLSTORE 

CLSTORE 

CLSTORE 

CLSTORE 

CLSTORE 

CLSTORE 

CLSTOBB 

CLSTORE 

CLSTOBE 

CLSTORE 

CLSTORE 

CLSTORE. 

CLSTORE 

CLSTORE 

CLSTORE 


00005 STORE 


00008 Pi It i leg q d ag s: G 


00010 The STORE coaeand alters the contents of specified 

00011 components of the virtual aacbine. The ccntents of the 

00012 following nay be altered; 

00016 • virtual storage locations 

00018 • general registers 

00020 • floating-point registers 

00022 • extended control registers (if available) 

00024 • prograa status word 

00026 The various options nay be conbined in any order desired, 

00027 separated by one or sore blanks, for up to cne full line cf 

00028 input. If an invalid arguaent is encountered, an error 

00029 aessage is issued and the store function is terminated; 

00029 however, if there have been valid arguments before the 

00040 invalid one, they would have been processed properly. 

00042 .-- 


00043 

I STOBB 

1 ( 

(hexloc } 




) 

00044 

1 ST 

It 

(Lhexloc) 

hexwordl 

[ hexword2.. • 

3 

) 

00045 

1 

I ( 





) 

00046 


t ( 

Shexloc 

hexdata 



) 

00047 

1 

1 ( 





1 

00048 


i ( 

(Greg) 




} 

00049 


1 ( 

(Treg) 

hexwordl 

[ hexvord2... 

3 

J 

00050 

1 

1 ( 

(Ireg) 




) 

00051 

1 

( ( 





} 

00052 

1 

1 ( 

PSM 

( hexwordl ; 

hexword2 


} 


00053 «-• 

00059 hexloc specifies that the data given in hexwordl 
00061 Lhexloc hexword2*., is to be stored in successive fullword 
00062 locations starting at the address specified by 
00063 hexloc. The saallest group of hexadeciaal values 
00063 that can be stored using this specification is one 
00064 fullword. Alignaent is Bade to the nearest 
00065 fullword boundary. If the value being stored is 
00066 less than a fullword (eight hexadeciaal digits), 
00066 it is right-adjusted in the word and the high 
00068 order bytes of the word are filled with zeros. 
00068 Either specification (hexloc or Lhexlcc) aay be 
00069 used. 

00071 Shexloc specifies that the data given in hexdata is to be 
00073 stored in the address specified by hexlcc without 
00074 word alignaent. The shortest string that can be 
00075 stored is one byte (two hexadeciaal digits). If 
00075 the string contains an odd number of characters. 
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CLSTORE 

00076 

CLST08E 

00078 

CLSTORE 

00080 

CLSTORE 

00082 

CLSTORE 

00083 

CLSTORE 

00083 

CLSTORE 

00084 

CLSTORE 

00085 

CLSTORE 

00088 

CLSTORE 

00089 

CLSTORE 

00089 

CLSTORE 

00090 

CLSTORE 

00091 

CLSTORE 

00092 

CLSTORE 

00095 

CLSTORE 

00096 

CLSTORE 

00096 

CLSTORE 

00097 

CLSTORE 

00098 

CLSTORE 

00099 

CLSTORE 

00100 

CLSTORE 

00101 

CLSTORE 

00104 

CLSTORE 

00107 

CLSTORE 

00109 

CLSTORE 

00110 

CLSTORE 

00111 

CLSTORE 

00112 

CLSTORE 

00113 

CLSTORE 

00116 

CLSTORE 

00116 

CLSTORE 

00117 

CLSTORE 

00117 

CLSTORE 

00119 

CLSTORE 

00121 

CLSTORE 

00123 


CLSTORE 

00126 

CLSYSTEH 

00001 


Greg 


Treg 


Xreg 


PSD 

P 


the last character is not stored. An errer 
message is sent and the function is terminated. 

specifies that the hexadeciaal data given in 
hexvordl hexvord2... is to be placed in successive 
general registers starting at the register 
specified by reg. The reg parameter ■ust be 
either a deciaal number ranging frea 0-15 or a 
hexadeciaal digit ranging frea 0-F. 

specifies that the hexadeciaal data given in 
hexvordl hexvord2... is to be placed in successive 
floating-point registers starting at tte register 
specified by reg. The reg parameter must be a 
digit ranging froa 0-6. If .reg is an edd number. 
It is adjusted to the preceding even number. 

specifies that the hexadecimal data given in 
hexvordl hexvord2... is to be placed in successive 
extended control registers starting at the 
register specified by reg. The reg parameter must 
either be a deciaal number ficm 0-15 or a 
hexadeciaal digit froa 0-F. If the user is in 
basic control aode, he can store data in register 
0 on ly. 

specifies that the hexadecimal data given in 
hexvordl hexvord2o.. is to be placed in the first 
and second vords of the user's virtual program 
status vord (PSH)• If only hexvord2 is specified, 
it is stored into the second void of the PSN. 
Hexvordl and hexvord2 must be separated ty one or 
more blanks. 


hexvord specifies up to eight hexadecimal digits. If less 
than eight digits are specified, the string is 
right justified in a fullvord and left-filled vith 
zeroes. If tvo or aore hexvords are given, they 
must be separated by one or aore blanks. 

hexdata specifies a string of tvo or mere hexadecimal 
digits vith no embedded blanks. 


BfiSEfiMfi 
STORE COMPLETE 
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CLSYSTEM 00003 SYST EM 


CLSISTEH 00006 fpjiyileqe C±a§g: G 


CLSYSTEM 00007 The SYSTEM command simulates the action of the BESET and 

CLSYSTEM 00008 RESTART buttons on the real computer confide, and alsc 

CLSYSTEM 00009 allows storage to be cleared. The RESET function and the 

CLSYSTEM 00010 CLEAR function leave the virtual aachine in a stopped state. 

CLSYSTEM 00C11 A BEGIN coaaand aust be issued to resume operation after a 

CLSYSTEM 00012 SYSTEM RESET. An IPL coaaand must be issued after a SYSTEM 

CLSYSTEM 00013 CLEAR coaaand. The virtual aachine is automatically 

CLSYSTEM 00014 restarted on a RESTART function at the location loaded into 

CLSYSTEM 00015 the PSM froa the doublevotd at virtual location zero. 

CLSYSTEM 00024 
CLSYSTEM 00025 
CLSYSTEM 00026 
CLSYSTEM 00027 
CLSYSTEM 00028 

CLSYSTEM 00035 CLEAR specifies that virtual storage and virtual storage 

CLSYSTEM 00036 keys are to be cleared to binary zeros. 

CLSYSTEM 00038 RESET specifies that all pending interrupts and 

CLSYSTEM 00039 conditions in the virtual aachine are tc be 

CLSYSTEM 00040 cleared. 

CLSYSTEM 00043 RESTART 
CLSYSTEM 00044 
CLSYSTEM 00045 
CLSYSTEM 00046 
CLSYSTEM 00047 


CLSYSTEM 

00050 

Responses 






CLSYSTEM 

00052 

STORAGE CLEARED 

- 

SYSTEM RESET 




CLSYSTEM 

CLSYSTEM 

00053 

00054 

This response 
entered. 

is 

given if the 

ccasand 

SYSTEM 

CLEAR is 

CLSYSTEM 

00056 

SYSTEM RESET 






CLSYSTEM 

CLSYSTEM 

00057 

00058 

This response 
entered. 

is 

given if the 

coaaand 

SYSTEM 

BESET is 

CLSYSTEM 

CLSYSTEM 

CLSYSTEM 

00060 

00061 

00061 

If the coaaand SYSTEM RESTART is 
given; the virtual aachine resumes 
in the virtual PSW loaded froa 

entered, no response is 
execution at the address 
virtual storage location 


siaulates the hardware system RESTART function by 
storing the current PSH at virtual location eight 
and loading* as the new PSV, the doubleword froa 
virtual location zero. Interrupt conditions and 
storage reaains unaffected. 


r~-■ —" i 

| SYSTEM | (CLEAR } | 

| SYS | (RESET } | 

| | (RESTART) ) 
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CLTEBH 


CLTEBH 


CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERf! 

CLTERf! 

CLTERf! 

CLTERf! 

CLTERf! 

CLTERf! 

CLTERf! 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 

CLTERN 


00003 TE RMINAL 


00006 ElililaaS Class: G 


00007 The TERNINAL coanand specifies various options used to 

00009 control terminal input and output processing. 

00019 f --1 


00020 

| TERMINAL 

1 ( 

(CHARDEL) 

[ON ) 

)* 

00021 

| TERM 

1 ( 

(LINEDEL) 

(OFF ) 

9 

00022 

1 

1 ( 

(LINEND } 

(char) 

) 

00023 

1 

i ( 

(ESCAPE ) 


i 

00024 

1 

1 ( 



i 

00025 

l 

i ( 

(MASK) 

(ON » 

} 

00026 

1 

1 l 

(A PL ) 

(OFF) 

) 

00027 

9 

1 ( 

(ATTN) 


) 

00028 

9 

9 ( 



} 

00029 

1 

9 ( 

LINESIZE 

nnn 

i 


00030 «--■» 


00035 * Hore than one function nay be specified in a single entcy 

00036 of the TERMINAL connand. For exanple: 


00038 ,-t 

00039 | TERMINAL CHARDEL OFF MASK ON LINESIZE 90 | 

00040 «- * 

00048 CHARDEL specifies that the logical character delete 

00050 CH function (nornally the a character) is to he 

00050 invoked according to specifications in the next 

00052 operand (ON, OFF, or char). Refer to "Appendix E: 

00053 Terninal Considerations" for an explanation of the 

00054 logical character delete function. 


00057 
00059 
00060 
0006 1 
00062 
00063 


LIHEDEL specifies that the logical line delete function 

LINED (nornally the t character) is ic te invoked 

according to sepcification in the next operand 
(ON, OFF, or char). Refer to "Appendix £: Terninal 
Considerations" for an explanation of the logical 
line delete function. 


00066 LINEND 

00067 LINEN 

00068 
00070 
00071 
00072 


specifies that the logical line end function 
(nornally the # character) is to te invoked 
according to specification in the next operand 
(ON, OFF, or char). Refer to "Appendix E: Terminal 
Considerations" for an explanation of the logical 
line end function. 


00075 

00076 

00077 

00078 


ESCAPE specifies that the logical escape character 

ES function (nornally the " character) is to be 

invoked according to the next operand (CN, OFF, or 
char). Refer to "Appendix E: Terninal 
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CLTEBH 

CLTERM 

C LTERM 
CLTEHH 

CLTERM 

CLTERM 

CLTERM 

CLTERM 

CLTERM 

CLTERM 

CLTBRM 

CLTERM 

CLTBRM 

CLTERM 

CLTERM 

CLTERM 

CLTERM 

CLTERM 

CLTERM 

CLTERM 

CLTERM 

CLTERM 

CLTERM 

CLTERM 

CLTERM 

CLTERM 

CLTERM 

CLTERM 

CLTERM 

CLTERM 


CLTEBH 


00079 

00080 


Considerations 11 for an explanation of the logical 
escape character function. 

00083 

00084 

ON 

specifies that the selected function is to be set 
to the systea default. 

00087 

OFF 

specifies that the selected function is to be 

00089 

OF 

eliainated. 

00092 

00092 

00093 

char 

specifies that this character is to be used for 
the specified function instead cf the standard 
setting. 

00096 

MASK 

is used to control the typing of a aask line at 

00097 

00098 

00099 

00100 

00102 

H 

the terainal when a password .is tc be entered. If 
ON is specified in the next operand, the VM/370 
systea will type the* aask line. If CFF is 
specified, the aask line is not typed and it up to 
the user to preserve the security cf his password. 

00104 

00106 

00107 

00108 

00108 

00110 

APL 

controls the use of APL character translation 
tables. If ON is specified,' CP uses the 
translation tables for terainals equipped with the 
standard APL typing elenent. If OFF is specified, 
CP will use the noraal translation tables (tnat 
is, BCD or correspondence code). 

00113 

ATTN 

with the ON option, noraal attention handling is 

00115 

00115 

00116 

00117 

AT 

in effect. The OFP option suppresses the typing 
of the (!) and carriage return fox these systeas 
that perfora special line editing using the attn 
key. 

00120 

LINESIZE 

nnn 

00122 

00123 

00124 

LINES 

allows the user to control the length of a typed 
line for bis terainal output, nnn is a count cf 
the nuaber of characters per line. 


00127 Re sponse 

None. 
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CLTBACE 


CLTBACB 


CLTHACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTHACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACB 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 


00005 2IASJ5 


00008 Privilege G 


00010 The TRACE coaaand causes the CP system to trace specified 
00011 virtual aachine activity aud to record the results at the 
00012 user's terminal, on a virtual spooled printer, cr cn both 
00013 terainal and printer. If trace output is being recorded at 
00014 the terainal, the virtual aachine stops execution and CP 
00015 console function node is entered after each output message. 
00017 This affects the siaulation of the single cycle function. To 
00017 resale operation at the virtual aachine, the BEGIN coaaand 
00018 aust be>entered. If the ROM option is specified, the virtual 
00020 aachine is not stopped after each output message, if trace 
00021 output is being recorded on a virtual spocled printer, a 
00022 CLOSE coaaand aust be issued to that printer in crder for 
00023 the trace output to be printed. Successful branches to the 
00024 next sequential instruction and branch-to-sclf instructions 
00025 are not detected by TRACE. Instructions that aodify or 
00026 exaaine the first two bytes of the text sequential 
00027 instruction will cause erroneous processing for BBAMCH and 
00028 INSTRUCT tracing. 

00040 t --—.. -.— - -- 


00041 

f TRACE 

1 CCSvc 

}* 




} 

00042 

| TR 

1CCi/o 

) 




I 

00043 

1 

|C(PROGRAN 

1 




J 

00044 

1 

| ((EXTERNAL) 

r 



l) 

00045 

1 

| ( (PRIV 

} 

) PRINTER 



i) 

00046 

1 

1 ((SIO 

1 

1 rr ■» 

r 

11 

u 

00047 


1({CCN 

} 


1 NOBUN 1 1 

1} 

00048 

1 

| ((BRANCH 

} 

)||BOTH | 

(RUN 

II 

1) 

00049 

J 

| ( (INSTRUCT) 

| C4. J 

L 

J J 

1) 

00050 

! 

1 ((ALL 

} 

I 



I) 

00051 

I 

1(CCS* 

) 

| OFF 



1) 

00052 

1 

| ( END 


t. 





00053 «---- 


00058 * Bore than one of these activities aay be traced by using 

00059 a single TRACE coaaand. For exaaple: 

00061 ,--, 

09062 1 TRACE SVC PROGRAN SIO PRINTER | 

00063 «- 1 

00069 SVC traces user SVC interrupts. 

00071 I/O traces user I/O interrupts. 

00073 PROGRAN traces user prograa interrupts. 

00075 PRO 
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CLTBACE 

CLTRACE 

00077 

00079 

EXTEBIAL 

EXT 

traces user external interrupts. 

CLTRACE 

00082 

PRIf 

traces all user privileged instructions. 

CLTBACE 

CLTRACE 

00085 

00087 

SIO 

traces all user I/O operations including SIC, 
FSIO, TIO, HIO, HD?, and TCH to victual devices. 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

00089 

00091 

00092 

00093 

CCB 

traces virtual and real CCR*s for 
non-spool/non-console device I/O operations. SIO 
tracing east be specified in order to get ecu 
tracing. 

CLTBACE 

00096 

BRANCH 

traces all user interrupts and all successful 

CLTRACE 

00098 

BE 

branches. 

CLTRACE 

00100 

INSTBOCT 

traces all instructions, user interrupts and 

CLTRACE 

00102 

INST 

successful branches. 

CLTRACE 

CLTRACE 

00105 

00105 

ALL 

traces all instructions, interrupts, successful 
branches, privilege instructions, and user I/O 

CLTRACE 

00106 


oper at ions. 

CLTRACE 

CLTRACE 

CLTRACE 

00109 

00109 

00111 

CSV 

provides contents of virtual and real channel 
status words at I/O interrupt. I/O sust have been 
specified if CSi is required. 

CLTRACE 

CLTRACE 

00114 

00115 

END 

terninates all fracing activity and print a 

terBination aessage. 

CLTRACE 

00118 
00120 V 

TERHIMAL 

specifies that the tracing is to be done on the 

CLTRACE 

TERR 

ferainal (virtual console)• 

CLTRACE 

00122 

PRINTER 

specifies that the tracing is to be done on a 

CLTRACE 

CLTRACE 

00124 

00126 

P 

PRT 

virtual spooled printer. 

CLTRACE 

CLTRACE 

00129 

00130 

BOTH 

specifies that tracing is to be dene both at the 
terainal and on a virtual spooled printer. 

CLTRACE 

00133 

OFF 

halts tracing of the specified activities on both 

CLTRACE 

00135 

OF 

terninal and printer. 

CLTRACE 

00137 

NORON 

specifies that for terninal output, progran 

CLTRACE 

CLTRACE 

CLTRACE 

00138 

00139 

00140 

NOR 

execution is to stop after the trace output has 
conpleted and that CP console . function node is to 
be entered. 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

00142 

00143 

00144 

00145 

RON 

specifies that for terninal output, the progran is 
to continue execution after the trace output has 
conpleted and that CP console function node is net 
to be entered. 
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CLTBACE 

00148 

Responses 



CLTRACE 

00149 

The following 

syabols are used in the responses received 

CLTRACE 

00150 

froB TRACE: 



CLTRACE 

00153 

WWW 

= 

virtual storage address 

CLTRACE 

00154 

tttttt 

= 

virtual transfer address or new ESW address 

CLTRACE 

00155 

rrrrrr 

= 

real storage address 

CLTRACE 

00156 

xxxxxxxx 

= 

virtual instruction, command, etc. 

CLTRACE 

00157 

yyyyyyyy 

~ 

real instruction, command, etc. 

CLTRACE 

00158 

type 

= 

virtual device name (DASD, TAPE, etc.) 

CLTRACE 

00159 

vaddr 

3S 

virtual device address 

CLTRACE 

00160 

raddr 

= 

real device address 

CLTRACE 

00161 

anen 

= 

mnemonic for instruction, etc. 

CLTRACE 

00162 

int 

= 

interrupt type (SVC, PROG, EAT, I/O) 

CLTRACE 

00163 

code 

= 

interrupt code number (in hexadecimal) 

CLTRACE 

00164 

n 

* 

condition-code number (0, 1, 2, ci 3) 

CLTRACE 

00168 

TRACE STARTED 



CLTRACE 

00170 

tracing has been 

initiated 

CLTRACE 

00172 

TRACE ENDED 



CLTRACE 

00174 

tracing has been 

suspended 

CLTBACE 

00179 

ot 

Mt 

* 

ol 

SI 

JifiVr nii b 21 ICiJ 


CLTRACE 

00181 

1 CH: 

CLTRACE 

00183 

Tea vwvvv type vaddr xxxxxxxx CC n 

CLTRACE 

00185 

HO, HIO or HDV 

CLTRACE 

00192 

r i 

CLTRACE 

00193 

|TIO| 

CLTRACE 

00194 

|HIO| vvvvw type vadd xxxxxxxx CC n RDEV racd CSW xxxx 

CLTRACE 

00195 

t j 

CLTRACE 

00197 

SI0.2I.ZSI2 

CLTRACE 

00199 

SIO vvwvv type vadd xxxxxxxx CC n RDEV radd CAW vvvvw 


CLTRACE 00201 ]}fi^ 
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CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTIiCI 

CLTRACE 
CLTRACE 

CLTIACB 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRACE 

CLTRANSP 


00208 CCJL (gIPALf QC "5S gg" Ua<j.iDSmd3a_gBll_U : 

00210 ccv vwvvv xxxxxxxx xxxxxxxx rrrrrr yyyyyyyy yyyyyyyy 
00212 CCS IDAL TffrmT nmm IDAL OOrrrrrr COrtcrcr 
0021% ccv seek xxxxxxxx xxxxxx seek yyyyyyyy yyyy 


00217 iPSTSflgTiag- m cnigs 


00219 

00221 



::: Turn boob xxxxxxxx 


00223 

00226 


... ¥f?Tf? EX XXXXXXXX »»V»?» BOOB XXXX XXXXXXXX 


00228 All Other In st ructions : 

00231 ... »Tf»T? BOOB XXXXXXXX XXXX 


00233 SP CCESSFOL flgANgg: 

00235 *»> TTTTTT BOBB XXXXXXXX tttttt 

00240 INTERRUPT (SVC. P8 QORAB. or EXTERN AL! 

00242 *** vwvvv int code tttttt 

00244 I/O INTERRUPT (First line given only if "CSV 
00245 specified): 

00248 csv r radd xxxxxxxx xxxxxxxx v vadd yyyyyyyy yyyyyyyy 

00001 *** vwvvv I/O vadd tttttt CSV xxxx 


was 
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CLTRANSF 

00003 

ISAElm 


CLTRANSF 

00006 

Privilege £Lla§§: D f G 

CLTRANSF 

CLTRANSP 

CLTRANSP 

CLTRANSF 

00008 

00009 

00010 

00011 

The TRANSFER coaaand directs a spool file to a specified 
user’s card reader. The file is deleted frci the sender's 
virtual device and is available in the recipient's virtual 
reader. 

CLTRANSF 

CLTRANSF 

CLTRANSP 

CLTRANSF 

CLTRANSF 

CLTRANSF 

00020 

00023 

00024 

00025 

00026 

00027 



| TRANSFER | r % {spoolid} [TO] userid | 

5 TRAN | tuserids (CLASS aj S 

j f | SISTER | (ALL ) I 

j S «- J 1 

u_.... J 



CLTRANSP 

CLTRANSF 

CLTRANSP 

00034 

00035 

00036 

userid 

(for use by Class D users only) this allows the 
spooling operator to aanipulate the spool files 
for a particular user. 

CLTRANSF 

CLTRANSF 

CLTRANSF 

00038 

00039 

00040 

SYSTEM 

(for use by Class D users only) this allows the 
spooling operator to aanipulate all sped files in 
the systen regardless of userid. 

CLTRANSP 

CLTRANSF 

00042 

00043 

spoolid 

specifies the file to be directed to the naaed 
userid. 

CLTRANSF 

CLTRANSF 

CLTRANSF 

00046 

00049 

00050 

CLASS a 
CL 

specifies that all files of the given class are to 
to be transferred, c is a one-character alphaaeric 
field with values froa A to Z and froa C to 9. 

CLTRANSP 

CLTRANSP 

00052 

00053 

ALL 

specifies that all spool files are to be 

transferred 

CLTRANSF 

CLTRANSF 

00057 

00061 

TO 

Y 

is an optional reserved keyword, if this hey word 
is oaiited? userid aay not be T or TO. 

CLTRANSP 

CLTRANSF 

00063 

00064 

userid 

specifies the user to whoa the files are to be 
directed. 

CLTRANSF 

00067 

Responses 

CLTRANSP 

00069 

RDB FILE 

spoolid TO userid 


CLTRANSP 00070 This is the response to the user issuing the TRANSFER 
CLTRANSF 00071 cowsand. One such response is given for each file 
CLTRANSP 00074 transferred* 
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CLTBANSF 

CLTRANSF 

CLTRANSF 


00076 (Dana) FILES TRANSFERRED 

00078 (RO } 

00080 is the response to the user who issued the TRANSFER coaaand. 


CLTRANSF 00082 
CLTRANSF 00085 


RDR FILE spoolid FBOH userid 

This is the response to the user receiving tie file 
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CLOILOCK 


CLUNLOCK 


CLUNLOCK 

CLONLOCK 

CLUNLOCK 

CLONLOCK 

CLONLOCK 

CLUNLOCK 

CLONLOCK 

CLONLOCK 

CLONLOCK 

CLONLOCK 

CLONLOCK 

CLOHLOCK 

CLONLOCK 

CLONLOCK 

CLONLOCK 

CLONLOCK 

CLONLOCK 

CLONLOCK 

CLONLOCK 

CLONLOCK 

CLONLOCK 

CLONLOCK 

CLONLOCK 


CLONLOCK 


CLVAHI 


00005 

aabQgjs 


00008 

BcAiUaaa Class: * 

00009 

00010 

The UNLOCK cob Band unlocks page fraaes previously locked by 
a LOCK coaaand. 

00019 

00020 

00021 

00022 



| UNLOCK | 

1 1 
• 

*1 

(userid fpage Ipage) ) 

(VIBT=BEAL ) ) 

. . - - - - , • 



00027 

00029 

userid 

is the user identification of the virtual user 
previously specified in a LOCK ccanand. 

00031 

00032 

fpage 

is the hexadeciaal value of the first page to be 
unlocked. 

00034 

00035 

Ipage 

is the hexadeciaal value of the last page to be 
unlocked. 

00038 

00038 

00039 

00040 

00042 

00043 

00044 

J 

specified, 
locations X 
be given: 

for fpage and Ipage, only the page nuabers are 
For exaaple, to unlock USEHA*s virtual storage 
*12000* to X*2C000*, the following coaaand should 

| UNLOCK 

a. - - -. 

USE BA 12 2C | 

.. . a 



00051 

00052 

00052 

00054 

VIBT-BBAL 

specifies that the page fraaes ncraally reserved 
for the virtual*real aachine are to be released 
for noraal paging use if the area is net 
occupied by a virt=real virtual aachine. 

00057 

Besponse 


00001 

COMMAND COMPLETE 
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CLTABT 


CLTABT 


CLTABT 

CLTABT 

CLVART 

CLTABT 

CLTART 

CLTABT 

CLTABT 

CLTABT 

CLTABT 

CLTABT 

CLTABT 

CLTABT 

CLTABT 

CLTABT 

CLTABT 

CLTABT 


CLTABT 


CLUNG 


00005 

Ikil 


OOOOS 

filiileag Slags? b 

00009 

OOOtl 

00012 

00012 

00013 

00014 

The TABT coeeend allows the operator to aark a device 
unavailable for use by a user or the ccntxcl pcograa. 
Devices aarked offline are reaeabered by the TH/370 systea 
through any virtual aachine systea failures. A shutdown and 
subsequent cold start will assune that all devices are 
available. 

00023 

00024 

00025 

00026 

00032 



i TABI 1 

1 1 
t 

DET rad.dr (ONLINE } i 

(OFFLINE) | 

• 

DET 

is a required reserved word. 

00034 

raddr 

specifies the real address (ecu) of the device. 

00036 

00038 

ONLINE 

ON 

specifies that a device previously offline is to 
be aade available. 

00040 

00041 

OFFLINE 

OF 

specifies that the device is to be aade unavailable 

00045 

Begponse 


00001 

CONHAND 

COflPLBTB 
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CLUNG 00005 Ufig 


CLUNG 00008 P yivj.leqe Clas s: A, B 


CLUNG 00009 The HHG connand Is used to traosRit high priority aessages 
CLUNG 00010 to a specified user or to all users. UNG docs not wait fcr 
CLUNG 00011 input operations at the terainal to conplete, but breaks in 
CLUNG 00012 on the line currently being typed and sends the nessage 
CLUNG 00013 ianediately* 

CLUNG 00022 
CLUNG 00023 
CLUNG 00024 
CLUNG 00025 
CLUNG 00026 


CLUNG 

00033 

userid 

specifies the user who is to receive the nessage. 

CLUNG 

CLUNG 

00036 

00039 

OPERATOR 

OP 

specifies that the nessage is to be sent to the 
prinary systen operator regardless of his userid. 

CLUNG 

CLUNG 

CLUNG 

00042 

00044 

00045 

ALL 

is for use by the systen operator to allow hia to 
broadcast the nessage to all users receiving 
warning aessages. 

CLUNG 

00040 

nsg-text 

specifies the sessage to be sent. 

CLUNG 

00051 

Bespgn^eg 


CLUNG 

00053 

UNG FHOH 

userid : nessage-text 


CLUNG 00055 This Is the response to the users who are to receive the 

CLUNG 00056 warning nessage. , 


| ung | (userid } 

| U | (OPERATOR ( 
I i (ALL ( 


nsg—text 
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CLSTAB 

CLSTAB 

CLSTAB 

CLSTAB 

CLSTAB 

CLSTAB 

CLSTAB 

CLBATCB1 


00008 * 

00011 Privilege £lig§: ALL 

00013 The * is used to annotate the console sheet with a ccaaent. 

00015 ,-, 

00016 i * | any—consent j 

00017 •---; --- - i 

00021 Bgaeaagag 

00001 None. 
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CLBATCH1 00004 
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CLBATCB1 00011 A£££iliai is CB S BATCH FACILIII 


CLBATCH1 00013 
CLBATCHI 00014 
CLBATCH1 00015 
CLBATCB1 00015 
CLBATCH1 00017 
CLBATCH1 00010 
CLATTKET 00001 


The CHS Batch Facility is a variation of the CBS systea 
which is controlled by an established input stress rather 
than interactive cossunication with a resote tersinal. The 
resote tersinal is required to initiate the CHS Batch 
virtual sachine. Any user say subsit a job streas tc the CHS 
Batch sachine, and, while the job streas is executing, 
continue regular CBS processing* 
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CLATTK8Y 


CLATTKBY 


CLATTKEY 

CLATTKEY 

CLATTKBY 

CLATTKEY 

CLATTKBY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKBY 

CLATTKEY 

CLATTKBY 

CLATTKBY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 


00011 A£££imj: XBfiJSIUAl 

00015 ATTENTION KEY HANDLING 


00016 

00017 

00018 

00019 

00020 

00021 

00022 

00023 

00024 

00025 

00026 

00027 

00029 

00029 

00030 


To simulate the functions of the central operator's console 
REQUEST and CANCEL keys, the terminal user *ay use the ATTN 
key (or its equivalent). Hefer to Figures 31-37 for the 
positions of the keys used to perforn the ITTN function cn 
the various terninal types. Each tine the tsex presses the 
ATTN key, CP types an exclanation point (!)s, sene "idle" cr 
nonprintable character, and a carriage retorn to indicate 
that the attention has been recognized. It the following 
chart, "one attention" aeans that the user presses the ATTN 
key and waits for the carriage to return; "two attentions" 
■eans that the user presses the ATTN key and while the 
exclanation point and the subsequent unprintable characters 
are being received at the terninal, presses ATTN again. More 
than two attentions is always the sane as two except as 
noted below. 


00032 

00033 

00034 

00034 

00035 

00036 

00038 


The action taken by CP when an attentiox is recognized 
depends upon the user's operating node and the state of his 
terninal. CP node indicates that the user is conversing with 
the Control Progran. VN node indicates that the user is 
conversing with the operating systen that is running in his 
virtual nachine. The user's terninal is always considered to 
be in one of four states: 


00043 

00046 

00048 

00049 

00051 

00053 


•Si the terninal is idle and its keyboard is locked. 

•S2 the terninal is receiving output fron the ccnputer. 

•S3 the terninal keyboard is unlocked for input but the 
user has not typed any characters. 

•S4 the terninal keyboard is unlocked for input and one or 
noce characters have been typed. 


00056 Figure 30 shows the action taken when a user presses the 
00057 ATTN key or its equivalent. 
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CLATTKEY 00060 
CLATTKEI 00061 
CLATTKEY 00062 
CLATTKEY 00064 
CLATTKEY 00065 
CLATTKEY 00066 
CLATTKEY 00067 
CLATTKEY 00068 
CLATTKEY 00069 
CLATTKEY 00070 
CLATTKEY 00071 
CLATTKEY 00072 
CLATTKEY 00073 
CLATTKEY 00074 
CLATTKEY 00075 
CLATTKEY 00076 
CLATTKEY 00077 
CLATTKEY 00078 
CLATTKEY 00079 
CLATTKEY 00080 
CLATTKEY 00081 
CLATTKEY 00082 
CLATTKEY 00083 
CLATTKEY 00084 
CLATTKEY 00085 
CLATTKEY 00086 
CLATTKEY 00007 
CLATTKEY 00088 
CLATTKEY 00089 
CLATTKEY 00090 
CLATTKEY 00091 
CLATTKEY 00092 
CLATTKEY 00093 
CLATTKEY 00094 
CLATTKEI 00095 
CLATTKEY 00096 
CLATTKEY 00097 
CLATTKEY 00098 
CLATTKEY 00099 
CLATTKEY 00100 
CLATTKEY 00101 
CLATTKEY 00102 
CLATTKEI 00103 
CLATTKEY 00104 
CLATTKEY 00105 
CLATTKEY 00106 
CLATTKEY 00107 
CLATTKEY 00108 

CLATTKEI 00110 Figure 30. Result of Attention Key Activation (Part 1 of 2) 


| BODS 

| STATE 

ATTN 

1 

ACTION 


i cp 

|S1- terainal 

Any* 

I 

keyboard unlocked for 


| idle,keyboard 


1 

input to CP. 

J 

1 locked 
|S2- terninal 

Any* 

» 

1 

active CE conand 


| receiving 


1 

terminated,, 


j output 

1 


1 

1 

keyboard unlocked for 
input to CP. 


1 

|S3— keyboard 

Any* 

1 

1 

attention interrupt iade 


1 unlocked, no 


1 

pending. 


j characters 


1 

victual lachine started at 


1 typed 


1 

address in current PSH. 


1 

| S 4— keyboard 

Any* 

1 

i 

input line cancelled. 


j unlocked,one 


1 

keyboard unlocked for 


j or lore char— 
j acters typed 


1 

1 

input to CP. 

| TB 

1 

1 SI— teriinal 

1 

1 

1 

attention interrupt iade 


j idle,keyboard 



pending. <* 


| locked 

1 

i 

1 

2 

1 

1 

1 

1 

keyboard unlocked for 
input to CP. 

any output being printed 
at the teriinal is deleted. 


1 

|S2- teriinal 

1 

1 

1 

attention interrupt iade 


| receiving 


1 

pending. 


| output 

1 


1 

1 

any output being printed 
at the teriinal is deleted. 


l 

1 

2 

1 

1 

keyboard unlocked fcr 


1 

t ! 


1 

input to CP. 


* When the terminal is in CP node, two ot lore attentions 
are treated the sane as one attention. 


** If the user is running CHS in his virtual nachine, he nay 
use this as a leans of stacking CHS ccuands. If a CHS 
coinand is executing and he wishes to enter a ccnnand to 
execute when the first one completes, he nay enter the 
second one when the Attention interrupt is recognized. 
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CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 

CLATTKEY 


00113 

— 



— 


- 1 

00114 

I MODE | STATE 

ATTN 


ACTICN 


00116 

1 

| S3— keyboard 

1 


unit exception status. 


00117 

1 

| unlocked, no 



control returned to 


00118 

1 

| characters 



virtual nachinc. 


00119 


1 typed 





00120 


1 

2 


device end status. 


00121 

1 

1 



keyboard unlocked for 


00122 

1 




input to CP. 


00123 


1 





00124 

1 

JS4- keyboard 

1 ■ 


unit exception status 


00125 

1 

(' unlocked,one 



control returned to 


00126 

1 

i or more char— 



virtual aachine. Any char- 


00127 

1 

j acters typed 



typed in are ignored. 


00128 

1 

1 

2 


device end status 


00129 

1 




any characters typed are 


00130 

1 

1 



saved in the virtual 


00131 





machine's memory. 


00132 

1 




control returned to 


00133 

1 

1 



virtual machine. 


00134 

a 





_J 

00136 

Figure 

30. Result of Attention Key 


Activation (Part 2 of 2) 
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CLATKEQV ^0^03 ATTENTION KEY EQUIVALENTS 



CLATKEQV 00008 Figure 31. IBM 2741 and IBH 105C Keytcard ATTN key 



3LATKEQV 0*012 Figure 32. IBB 1052 Keyboard ATTENTION LINE BESET key 
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CLATKBQV 00017 


CLATKEQV 00021 


CLATKBQV 00C25 



Figure 33. IBM 3330 Model 1 and 3EM 3335 Keyboard BEQUEST key 



Figure 34. IBM 3210 Model 2 Keyboard HEQUEST key 



Figure 35. IBM 2150 Keyboard BEQUEST key 
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CLATK3QV 


CLATK3QV 


LATK3QV 

LATKEQV 


00030 


00034 


' . 

o o 

«• •* 

o o 

•*. - . 


o 6 

OOCDClXDOOCDOOOO© 

©OO©©©G)O(D0©<§)© 

©O©©©©OO©©O<5)©0 

©OOOOOCDOOOO© 

1 — I 

6 ' © 

fMItNIM* 

ft. 

U 

0.0 0 0 00 


Figure 3-6. Teletype* Model 33 Keyboard EBEAK key 


L 

OOdXDaxDOOOGXDO 

©©©©©© 000 ©©©© 


000006 

©0©®©©00©©0© 

0 

ttei •* •" •* *• 

©ooooo©ooo©© 


666666 

© 1--””1©©© 

- 



566666 


Figure 37* Teletype* Model 35 Keyboard BBEAK key 


O00 37 --- 

n 9039 * Tradeaark of Teletype Corporation, Skokie, Illinois 
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CLLNEDIT 


CLLNBDIT 

CLLNEDIT 

CLLNEDIT 

CLLNBDIT 

CLLNEDIT 

CLLNBDIT 

CLLNEDIT 

CLLNBDIT 

CLLNEDIT 

CLLNEDIT 

CLLNEDIT 

CLLNEDIT 

CLLNBDIT 

CLLNEDIT 

CLLNEDIT 

CLLNEDIT 

CLLNEDIT 

CLLNBDIT 

CLLNEDIT 

CLLNEDIT 

CLLNEDIT 

CLLNEDIT 

CLLNEDIT 

CLLNEDIT 

CLLNEDIT 

CLLNBDIT 

CLLNEDIT 

CLLNEDIT 

CLLNEDIT 

CLLNBDIT 

CLLNEDIT 

CLLNEDIT 

CLLNEDIT 

CLLNEDIT 

CLLNEDIT 

CLLNEDIT 

CLLNEDIT 
CLLNEDIT 
CLLNEDIT 
CLLNEDIT 
CLLNEDIT 
CLLNEDIT 
CLLNEDIT 


00010 SPECIAL VM/370 LOGICAL LINE EDITING CHABACTEfS 


00012 VM/37C normally edits all input lines entered in either CP 
00013 node or lines entered to a system in a virtual nachine. The 
00014 editing of input for the virtual nachine nay be turned off 
00015 by the CP comand SET LINEDIT OFF. All cf the editing 
00016 characters are renoved from the input line before it is 
00017 passed to the user's virtual nachine. The fcur editing 
00018 functions defined in CP are described below. 


00021 

00021 

00023 

00023 

00025 


Logi c al Cha r acter Delete - The logical Character Delete 
character causes the preceding character to be deleted 
fron the input line. The Character Delete character 
can be used to delete a line end character and a line 
delete character. 


00028 

00028 

00029 

00030 

00031 


Logi c al Lin e End - The logical Line End character causes a 
new line character, hexadecimal '15', to be inserted 
into the input line. The new line character is treated 
as the end of a logical line by both the CP and CMS 
input processors. 


00034 

00035 

00036 

00036 

00037 

00038 

00039 

00039 

00040 


Logi c al Line Delet e - The logical Line Delete character 
causes the current logical line to be deleted fron the 
input line. If the Logical Line Delete character 
innediately follows a new line character, both the 
current and previous logical lines arc deleted. The 
current logical line begins innediately following the 
previous new line character or at the beginning of the 
physical line if no new line character is present in 
the line. 


00042 

00043 

00043 

00044 

00045 

00047 

00047 

00048 

00049 

00050 


Logi c al Esc a pe - The logical Escape character causes the 
character following it to be ignored as an input line 
editing character. This allows any of the above 
editing characters to be interpreted literally instead 
cf as an editing character without redefining that 
editing character. An ESCAPE character appearing as the 
last character of a line is renoved frcn the line and 
ignored. Any of the logical line editing characters 
including the logical escape character nay be entered 
as data if preceded by an escape character. 


00053 The default input line editing characters foi the systen are 
00053 listed in Figure 38. An. installation nay redefine these 
00055 default characters for an individual user in the user 
00056 directory. A user nay alter the character associated with 
00057 each function, or delete the function entirely for the 
00058 duration of the current terninal session by using the CP 
00059 TERMINAL Conaand. 


0 
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CLLIEDIT 00067 
CLLVBDTT 00068 
CLLREDIT 00069 
CLLBEDIT 00070 
CLLBEDIT 00071 
CLLREDIT 00072 
CLLNBDIT 00073 
CLLBEDIT 00079 
CLLBEDIT 00075 

CLLBEDIT 00079 


cllbedit 0008 L ImjBl&g at Iks flat at iia a Mtilaa £*911215IS 
CLLBEDIT 00093 Typed: BBBDidADCABD 

CLLBEDIT 00095 Basalt: BBADCABD 


CLLBEDIT 00097 Typed: QOEBI I S»»ux9»0SBBSMQ0BBI BABES 

CLLBEDIT 00099 Basalt: QOEBI BABES 


CLLBEDIT 00101 Typed: HSG ALL FILE ""BACL1B"" IS BE1BC OPIATIC 

CLLBEDIT 00103 Basalt: BSG ALL FILE *8ACLIB" IS BEIBG OPDATID 


CLLBEDIT 00105 Typed: QOEBI BABES • QOEBI FILES • QOEfI OSEBS # SIB 

CLLBEDIT 00107 Basalt: aall line 


CLLBEDIT 00109 Typed: Q BABBS # Q FILES «BQ OSEBS * 

CLLREDIT 00111 Basalt: Q BABES- 


CLLBEDIT 00113 Typed: SBT LIREDIT OFF • BEED99AECABD 

CLLBEDIT 00115 Basalt: SBT LIBBDIT OFF 

CLLBEDIT 00116 BBADCABD 

CLLBEDIT 00122 Bote : The satire physical line is scanned before any 

CLLBEDIT 00123 coaaand is executed; therefore, the second logical line 

CLLBEDIT 00129 would have bean scanned before the coanand in the first 

CLLBEDIT 00125 logical line was executed. 

CLLBEDIT 00128 Typed: SET LIBBDIT OFF (carriage return) 

CLLBEDIT 00129 BBBD99ADCABD 

CLLBEDIT 00131 Basalt: BBBDfttADCABD 


386 
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CLLNEDIT 00133 Lina editing has been turned off by the connand 

CLLNEDIT 00135 SET LINEDIT OPP 

CLLNEDIT 00138 Typed: 01632 This line of texdsdxt is to te inserted 

CLLNEDIT 00139 in a file at seq no 015362*3932 

CLLNEDIT 00141 Besult: 01632 This line of text is tc be inserted in a 

CLLNEDIT 00142 file at seq no 01632 
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CLDISKDI 

00007 

4|PSmi_£: J2I2JS (Eil2»2dS J3aJ>sggasil£) 



CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

00008 
00009 
00010 
0001 1 

The table in Figure 39 relates CMS commands, method 
specifying filemode, and the criteria used in choosing 
disk directory for reading and writing. Symbols used in 
table are: 

cf 

a 

the 

CLDISKDI 

CLDISKDI 

00014 

00017 

command 

Meaning 

CMS command name 



CLDISKDI 

00020 

fm 

explicit mode letter can be specified 



CLDISKDI 

00023 

= 

Write disk to Bead disk 



CLDISKDI 

00026 

* 

refer to all disks in a set search order 



CLDISKDI 

00029 

d 

default node: let system determine where-to-go 


CLDISKDI 

CLDISKDI 

00031 

00032 

- 

null mode; unable to specify mode letter 
command 

in this 

CLDISKDI 

00035 

Beading 

the criteria for choosing the disk to be read from 

CLDISKDI 

CLDISKDI 

00037 

00038 

N/A 

not applicable, command does not cause any 
to be done 

reading 

CLDISKDI 

00041 

fa 

read from the specified disk 



CLDISKDI 

00044 

+ R 

refer to all disks in the standard search 

order 


CLDISKDI 

00047 

1R 

read only from the primary disk 



CLDISKDI 

CLDISKDI 

00049 

00050 

Hr iting 

indicates the criteria for selecting the 
write to 

disk 

to 

CLDISKDI 

CLDISKDI 

00052 

00053 

N/A 

not applicable, command does not cause any 
to be done 

writing 

CLDISKDI 

"0056 

fm 

write to the specified disk 



CLDISKDI 

CLDISKDI 

00058 

00059 

R 

write to the disk from where a file was 

its parent 

read. 

or 

CLDISKDI 

"0062 

*H 

choose any B/W disk in the standard search 

pattern 

CLDISKDI 

"0065 

1W 

attempt to write onto the primary disk 

. J 
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CLDISKDI 

CLDISKDI 

0 0073 

0007* 

i £211*311 

FilQEQde 

isailaa 

1 

.Siitiaa 

L L D1SKDI 

0 UU7d 

1 





CLDISKDI 

00076 

| ACCESS 

£■ 

fa 

1 

N/A 

CLDISKDI 

00077 

1 



I 


CLDISKDI 

00078 

| ASSEMBLE 

— 

*R 

! 

R,1H # *W 

CLDISKDI 

00079 

1 



1 


CLDISKDI 

00080 

| BASIC 

- 

*R 

1 

R, IN 

CLDISKDI 

00081 

1 



1 


CLDISKDI 

00082 

|*COBOL 

— 

*R 

1 

R,1 

CLDISKDI 

00083 

1 





CLDISKDI 

00084 

| COMPARE 

fa 

fa 

1 

N/A 

CLDISKDI 

00085 

1 

* 

*R 

1 

N/A 

CLDISKDI 

00086 

1 

d . 

1R 

I 

N/A 

CLDISKDI 

00087 

1 



1 


CLDISKDI 

00088 

|*COM VERT 

fa 

fa 

1 

fa 

CLDISKDI 

00089 

1 



1 


CLDISKDI 

00090 

| COPIFILE 

fa 

fa 


fa 

CLDISKDI 

00091 

1 


N/A 


R 

CLDISKDI 

00092 






CLDISKDI 

00093 

| CP 

- 

N/A 

1 

N/A 

CLDISKDI 

00094 

1 



1 


CLDISKDI 

00095 

| DEBUG 

- 

N/A 

1 

N/A 

CLDISKDI 

00096 




1 


CLDISKDI 

00097 

| DISK DOHP 

fa 

fa 

1 

N/A 

CLDISKDI 

00098 

1 

* 

*R 

1 

N/A 

CLDISKDI 

00099 

1 

d 

IB 

1 

N/A 

CLDISKDI 

00100 

| LOAD 

— 

N/A 

1 

IN 

CLDISKDI 

00101 

1 



1 


CLDISKDI 

00102 

| EDIT 

fa 

fa 

1 

R , 1 U 

CLDISKDI 

00103 

1 

* 

*R 

1 

R, IN 

CLDISKDI 

00104 


d 

1R 

1 

R, 1W 

CLDISKDI 

00105 




1 


CLDISKDI 

00106 

| ERASE 

fa 

N/A 

1 

fa 

CLDISKDI 

00107 

1 

* 

N/A 

1 

* H 

CLDISKDI 

00108 

1 

d 

N/A 

1 

1W 

CLDISKDI 

00109 




1 


CLDISKDI 

00110 

| EXEC 

- 

*R 

1 

N/A 

CLDISKDI 

00111 




1 


CLDISKDI 

00112 

| FILEDEF 

fa 

fa 

1 

fa 

CLDISKDI 

0 0113 

1 

d 

1R 

1 

1 u 

CLDISKDI 

00114 

1 

* 

*R 

1 

R, IN 

CLDISKDI 

00115 

1 



1 


CLDISKDI 

00116 

| *PORTGI 

— 

*R 

1 

R, IN 

CLDISKDI 

00117 




1 


CLDISKDI 

00118 

|*FORTHX 

- 

*R 

1 

R,1U 

CLDISKDI 








1 - 





CLDISKDI 

00120 

I * IBM Progcai Products 




00121 






w Afi/i, JI\ UJL 






CLDISKDI 

00123 

Figure 39. Disk Determination (Part 

1 cf 3) 
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CLDISKDI 

CLDISKDI 

00126 

00127 

l ggaaaafl i lilaiais 

t Sealing 

1 


L L 1)1S K DI 

0 0128 

i 





CLDISKDI 

00129 

| GENDIET 

- 

1 N/A 

1 

N/A 

CLDISKDI 

00130 



1 

1 


CLDISKDI 

00131 

| GENHOD 

£■ 

1 N/A 

I 

fa 

CLDISKDI 

00132 

1 

* 

1 N/A 

1 

IN 

CLDISKDI 

00133 


a 

1 N/A 

1 

IN 

CLDISKDI 

00134 




1 


CLDISKDI 

00135 

| GLOBAL 

- 

1 N/A 

1 

N/A 

CLDISKDI 

00136 



1 

1 


CLDISKDI 

00137 

|*GOF08T 


\ *R 

1 

R, IN 

CLDISKDI 

00138 

1 


1 

1 


CLDISKDI 

00139 

| INCLUDE 

— 

| *R 

1 

IN 

CLDISKDI 

00140 

1 


1 

1 


CLDISKDI 

00141 

| LISTFILE 

fa 

1 f* 

1 

1 W 

CLDISKDI 

00142 

1 

* 

| *R 

1 

IN 

CLDISKDI 

00143 

1 

d 

i IB 

1 

IN 

CLDISKDI 

00144 

1 


! 

1 


CLDISKDI 

00145 

| LOAD 

- 

f *R 

1 

IN 

CLDISKDI 

D0146 

1 


I 

J 


CLDISKDI 

00147 

| LOADMOD 

— 

| *R 

1 

N/A 

CLDISKDI 

00148 

J 

fa 

1 fa 

1 

N/A 

CLDISKDI 

00149 



\ 

1 


CLDISKDI 

00150 

| MACLIB 

- 

1 IB 


IN 

CLDISKDI 

00151 

1 


1 

1 


CLDISKDI 

00152 

| MODHAP 

- 

1 *B 

1 

N/A 

CLDISKDI 

00153 



1 

I 


CLDISKDI 

00154 

| MOVEFILE 

fa 

f fa 

1 

f ID 

CLDISKDI 

00155 

1 


1 

i 


CLDISKDI 

00156 

|*PL IOPT 

— 

| *R 

1 

R,1N f *N 

CLDISKDI 

00157 

1 


\ 

l 


CLDISKDI 

00158 

| PRINT 

fa 

| f m 

l 

N/A 

CLDISKDI 

00159 

1 

d 

1 IB 

1 

N/A 

CLDISKDI 

00160 

1 

* 

| *R 

i 

N/A 

CLDISKDI 

00161 

1 


1 

1 


CLDISKDI 

00162 

| PUNCH 

fa 

| £ B 

i 

N/A 

CLDISKDI 

00163 

i 

d 

1 IB 

i 

N/A 

CLDISKDI 

00164 


* 

| *R 

i 

N/A 

CLDISKDI 

00165 

1 


1 

i 


CLDISKDI 

00166 

| QUERY 

- 

I n/a 

i 

N/A 

CLDISKDI 

00167 

1 



i 


CLDISKDI 

00168 

| RBADCAHD 

fa 

1 n/a 

i 

(fa) 

CLDISKDI 

00169 

1 

— 

1 n/a 

1 

fa 

CLDISKDI 

00170 


d 

1 N/a 

i 

1 H 

CLDISKDI 

00171 

1 

* 

1 N/a 


IN 

CLDISKDI 

00172 

1 



i 


CLDISKDI 

00173 

| RELEASE 

— 

j cuu 

• 

N/A 

CLDISKDI 

00174 


fa 

i fa 

l 

N/A 


o rt 17*; 






CLDISKDI 

O0176 

| * IBM Prog can Products 




00177 












CLDISKDI 

00179 

Figure 39* Disk Determination (Part 

2 Of 3) 
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CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 

CLDISKDI 


00182 

00183 

r 

1 

t 

lUaM&a 

1 figaifliflfl 

I 

00185 

1 

BENAHE | 

fa 

1 fa 

i fa 

00186 

1 


* 

| *B 

i R 

00187 

1 


* 

1 N/A 

I R 

00188 

00189 

1 

1 

BON | 

fa 

1 

1 fa 

1 N/A 

00190 

1 


* 

| *R 

1 N/A 

00191 

1 


— 

| *R 

1 N/A 

00192 

00193 

1 

1 

SET | 

_ 

1 

1 N/A 

1 

1 N/A 

00194 

00195 

1 

1 

SOBT | 

fa 

1 

i fa 

1 

1 fa 

00196 

1 


* 

| *B 

1 R » 1N 

00197 

00198 

1 

1 

STABT ! 


1 

I N/A 

8 

1 N/A 

00199 

00200 

f 

1 

STATE | 

fa 

1 

| fa 

1 

8 N/A 

00201 

1 


* 

| *R 

1 n/a 

00202 

1 


d 

| *B 

IN/A 

0 0203 
00204 

1 

1 

SVCTBACE | 

_ 

1 

1 N/A 

1 

1 N/A 

00205 

00206 

1 

SYNONYM | 

fa 

1 

1 fa 

1 n/a 

00207 

1 


* 

1 *R 

1 N/A 

00208 

00209 

1 

1 

TAPE DUNP| 

fa 

| fa 

1 

1 N/A 

00210 

1 


* 

| *R 

1 n/a 

00211 

1 


d 

| *R 

1 N/A 

00212 

1 

LOADI 

fa 

i N/A 

I fa 

00213 

1 


d 

1 N/A 

1 IN 

00214 

I 


* 

1 N/A 

1 IN 

00215 

1 

SCAM | 

— 

1 n/a 

1 N/A 

00216 

1 

SKIPI 

— 

1 N/A 

1 N/A 

00217 

00218 

1 

1 

TAPPDS | 

fa 

1 

1 N/A 

| f a 

00219 

1 


d 

1 N/A 

I 1N 

00220 

00221 

1 

1 

TXTLIB | 


1 

| *B 

1 

1 1 N 

00222 

00223 

1 

1 

TYPE | 

fa 

i fa 

1 

1 n/a 

00224 



* 

| *R 

1 n/a 

00225 

1 


d 

| 1R 

I N/a 

00226 

00227 

1 

UPDATE | 


| *R 

1 

1 R,1W 

00228 

L 




— . . . . . - 


00230 Figure 39* Disk Determination (Part 3 of 3) 
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CLFILETP 

00006 

A£E£lim fi: ££5IM£C 

CLFILETP 

00009 

The following table 

CLFILETP 

00010 

in CMS. 


UUXIU J2f£££im£A2 

shows filetypes that ha\e special uses 


CLFILETP 

CLFILETP 

CLFILETP 

00019 

00020 

00021 

i— 

| FILETYPE 

1 

| COMMAND 

USAGE 

| FILENAME 

1 

J FORMAT 

| RECFM LREC1 

| CCNTENI3 

1 

CLFILETP 

00022 




1 

■ 



CLFILETP 

00023 

| ASSEMBLE 

i ASSEMBLE 

input 

I f n 

1 f 

80 

| Assembler Lan 

CLFILETP 

00024 

1 



1 

1 


| Scurce staten* 

CLFILETP 

00025 





1 


1 

CLFILETP 

00026 

| BASIC 

| BASIC 

input 

1 f n 

1 F 

80 

I BASIC languag 

CLFILETP 

00027 

1 



1 

1 


| scurce statem 

CLFILETP 

00028 

1 



J 

I 



CLFILETP 

00029 

| BASOATA 

| BASIC 

execution-1 fn 

i o 

<3440 

| user input an 

CLFILETP 

00030 


|execution 

tine files 

1 

1 


Icutput files 

CLFILETP 

00031 




1 

1 



CLFILETP 

00032 

| CMS0T1 

| READCARD 

inter- 

| READ 

| F 

80 

1 

CLFILETP 

"0033 

1 

| COPYFILE 

aediate 

| COPYFILE 

1 


1 

CLFILETP 

00034 


| DISK 

work 

j diskloac 

1 


1 

CLFILETP 

00035 


| TAPE 

file 

| TAPELGAC 



1 

CLFILETP 

00036 

1 

| UPDATE 


1 in 

1 


1 

CLFILETP 

00037 

i 

| INCLUDE 


( DMSLDR 

1 



CLFILETP 

00038 


| LOAD 


1 dAsldr 

1 


1 

CLFILETP 

00039 

1 

| MACLIB 


| DNSLBM 

1 


1 

CLFILETP 

00040 

1 



1 



1 

CLFILETP 

00041 

| COBOL 

| COBOL* 

input 

i in 

1 f 

80 

1 COBOL source 

CLFILETP 

00042 


1 


1 

1 


| dents 

CLFILETP 

00043 

1 

| 


1 



1 

CLFILETP 

00044 

| COPY 

| MACLIB 

input 

1 f n 

1 F 

80 

| *COPY control 

CLFILETP 

00045 


( 


1 

1 


I ana macro 

CLFILETP 

00046 

i 

I 


I 



| definitions 

CLFILETP 

AO047 

i 

| 



1 



CLFILETP 

00048 

| EXEC 

| EXEC 

input 

1 fn 

t F 

ac 

| EXEC statemen 

CLFILETP 

00049 

1 

| LISTFILE 

output 

| CMS 

i 


1 

CLFILETP 

00050 




1 

1 



CLFILETP 

00051 

| FORTRAN 

J FORTG1* 

input 

| t n 

1 F 

80 

| FORTRAN SOULC 

CLFILETP 

00052 


I FORTHX* 


I 

1 


| statements 

CLFILETP 

00053 

1 

j GOFORT* 


1 

1 


J 

CLFILETP 

00054 

1 

1 


J 



1 

C LPILETP 

"0055 

| FTnnFOO1 

| FORTRAN 

input/ 

I fn 

1 


I user input an 

CLFILETP 

00056 

1 

(execution 

output 

1 

1 


1 output tiles 

CLFILETP 

"0057 


( 


1 

1 


1 

CLFILETP 

00 "5 8 

| LISTING 

| ASSEMBLE 

output 

| fn 

1 F 

12 1 

I processor prii 

CLFILETP 

noP59 


J FORTRAN* 

output 

1 t n 



I output 

CLFILETP 

"0060 

1 

| compilers 


1 

1 


1 

CLFILETP 

"0061 

1 

J COBOL* 

output 

| f n 

1 


1 

CLFILETP 

00062 


| PLIOPT* 

output 

1 f n 

1 


1 


r\ r. n a i 








CLFILETP 

000 64 

1 
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CLPILETP 

9 " " 6 5 



- IN 1 - - 


• ... 




CLFILETP "0067 Figure 40. Reserved Filetypes (Part 1 cf 2) 
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ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 

ILETP 
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00070 






. ‘ " 

n 

00071 

| PILETYPE 

| COMMAND 

| USAGE 

| FILENAME 

| FOIHAT 

| CONTENTS 


00072 

00073 

1 MACLIB 

| GLOBAL 

I library 

1 Yd 

(library contains 

| macro definitions 


0 0074 

i 

| MACLIB 

| MACLIB 

j £ n 

(dictionary and 

1 macro definitions 


00075 

1 

1 


1 

I leakers 



00076 

I 



1 

1 



00077 

| MACRO 

| MACLIB 

| input 

1 £ c 

( F 80 

| macro definitions 


00078 


1 


1 




00079 

| MAP 

| INCLUDE 

| output 

| LOAD 


( module map 


0 0080 

1 

| LOAD 

I output 

| LOAD 


| module map 


00081 

1 

| MACLIB 

| output 

I f n 

1 

| library »ap 


00082 

1 

| TXTLIB 

| output 

1 f n 

1 

I library map 


00083 

1 

1 


1 

1 



00084 

| MEMO 

1 


| £n 

| F 30 



00085 

1 

1 


1 

1 



00086 

| MODULE 

| GENMOD 

| output 

| £ Q 

i v 

| non—relocataole 


00087 


| LOADMOD 

| input 

| f n 


| object file 


00088 

1 

| MODNAP 

j input 

i f n 

1 



0 0089 

1 

1 






00090 

| PLI 

| PLIOPT* 

| input 

| t □ 

1 F 

| PL/I source 


00091 

1 

1 


1 

1 

| statements 


00092 

1 

1 


1 




0 0093 

| SYNONYM 

| SYNONYM 

| reference 

1 £ n 

| F 60 

| command name 


O0C94 

1 

1 


1 

1 

| synonyms 


00096 

1 

1 


1 




'■'0097 

| SYSUT1.2» 

31 ASSEMBLE 

| work 

1 £ n 

i v 



00098 


| COBOL* 

| work 

| f n 

1 



00099 

1 

| PLIOPT* 

j work 

| f n 




00100 

| SYSUT4 

| COBOL* 

| work 

1 £n 

| F 8C 



00101 

| SYSUT5 

| COBOL* 

j output 

1 £n 

1 F ’ 

I relocatatle object 


00102 

1 



t 


( code 


*0103 

1 




1 



00104 

| TEXT 

| ASSEMBLE 

| output 

1 £ n 

|f 60 

| object cede 


* 0 105 

1 

| COBOL* 

| output 

1 f n 


| object cede 


00106 


| INCLUDE 

| input 

J £ n 

» 

( ceject cede 


00107 


| LOAD 

| input 

| £ n 

1 

} object code 


00108 


j PLIOPT* 

| output 

1 £ d 

( 

| object code 


*0109 

1 

| TXTLIB 

| input 

| f n 

1 

( object code 


00110 


| FORTRAN* 

| output 

1 £ n 

1 

| object file 


00111 


I coapilers 


1 

1 



00112 


1 



1 



*0113 

| TXTLIB 

| GLOBAL 

| library 

1 f n 

llitrary contains 

| object decks 


00114 

1 

1 TXTLIB 

| output 

j £n 

(dictionary and 



00115 

1 

1 


1 

| aevkers 



*0116 


1 


1 




O0117 

| UPDATE 

1 UPDATE 

| input 

1 f n 

I F 60 

( UPDATE control 


*0118 


1 


J 


1 cards 


00119 


1 


1 

1 



00120 

| UPDLOG 

| UPDATE 

| output 

j £ n 

1 t 

| UPDATE leg 


00122 

| * IBM Program Products 





00123 

t_— ... 

— — — ■ . . —- 



--- - 


. j 
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CLSAHPTH 


CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 


00006 &£££i£U £: £A££Jtl IJEIfiJMi 5£S£i2J* 


00009 

00011 

00012 

00014 

00016 

# 

va/370 online xquvtz noxudj 

login smith mask 

ENTER PASSWORD: 

-Attention key hit 

00018 

00C19 

00021 

LOGMSG - 12:37:20 04/13/72 

-The password is typed in over 
the aask 

00022 

* VH/370 WILL BE UP 24 HOURS 

A DAY 

00023 

00024 

* MAINTENANCE PERIODS WILL BE 

* 48 HOURS IN ADVANCE 

ANNOUNCED 

00026 

00028 

LOGON AT 14:26:31 EST THURSDAY 

ipl cas 

04/13/72 

00030 

CHS VERSION 1.0 4/13/72 12:38: 

10 

00034 

00035 

00035 

access 191 a (noprof 

-The user wishes to gain 

access to the CMS system hut 
does not want his liile. 

00037 

00040 

8; T 3 0.09/1.25 12:38:40 

PROFILE EXEC to te executed. 

00°42 

00042 

OQ043 

set rdyasg sasg 

-The user doesn’t want to 

receive the. leng READY 

message after each command 

09045 

fi; 

-short ready message 

00047 

00047 

00048 

00050 

set blip blip 

R; 

-The user wishes to have a 
printed record cf the CPU 
tine used. 

0 0053 
^0^53 
00054 
00054 
00054 

edit testprog assaable 

-A new file is tc te created 
with a file identifier of 
TESTPROG ASSEMBLE A1, it will 
have the default 

characteristics fci tiletype 

00055 


ASSEMBLE 

00059 

00060 

NEW FILE: 

-The file does net currently 
exist and will be created 

00063 

00064 

EDIT: 

-The EDIT environment is 

entered 

00068 

00^68 

input 

-The user wishes tc enter the 
INPUT envirement tc type in 
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CLSANPTN 

00069 



the program 

CLSANPTN 

00072 



-INPUT environxert is entered 

CLSANPTN 

00074 

INPOT: 


CLSAUPTN 

00077 

testprog 

csect 

-Text of prograa 

CLSAUPTN 

00C78 


using 

*,15 

CLSANPTN 

00079 


save 

(14,12) 

JLSAHPTN 

00080 


St 

13, savearea+4 

CLSANPTN 

00081 


bal 

12,around 

CLSANPTN 

00082 


using 

savearea, 13 

CLSANPTN 

00083 

savearea 

ds 

18f 

CLSANPTN 

00084 

around 

egu 

* 

CLSANPTN 

00085 


St 

12,8(13) 

CLSANPTN 

00086 


lr 

13,12 

CLSANPTN 

00087 


vto 

•this is output of a saaple* 

CLSANPTN 

00088 


wto 

• ** ***** aggea bi er **********» 

CLSANPTN 

00089 


vto 

»******anguage************ 

CLSANPTN 

00090 


vto 

»** *****prograa************* 

CLSANPTN 

00091 


1 

13,4(13) 

CLSANPTN 

00092 


xr 

15, 15 

CLSANPTN 

00093 


retura (14,12) , rc* (15) 

CLSANPTN 

00094 


end 


CLSANPTN 

00099 



-Carriage return hit to 

CLSANPTN 

00103 



return user tc ECU 

CLSANPTN 

00105 



environment 

CLSANPTN 

00109 

EDIT: 


-EDIT environment entered 

CLSANPTN 

00113 

file 


-The file is saved on disK 

CLSANPTN 

00116 

R; 


-The EDIT command has 

CLSANPTN 

00117 



completed. Conticl is 

CLSANPTN 

00118 



returned to CES 

CLSANPTN 

00122 

global aaclib 

osaacro -The program tc be assembled 

CLSANPTN 

00122 



contains macics which are 

CLSANPTN 

00122 



included ic the macro 

CLSANPTN 

00123 



library, OSEACBC NACLIB. 

CLSANPTN 

00123 



This command specifies that 

CLSANPTN 

00124 



the library is to be searched 

CLSANPTN 

00125 



for all macros 

CLSAHPTN 

00128 

R; 



CLSANPTN 

n 11 31 

assemble 

testprog -The System Assemtler is 

CLSANPTN 

O0131 



invoked to assextle the 

CLSANPTN 

00131 



source statements included xn 

CLSANPTN 

00133 



tha file, TESTPBOG ASSEMBLE 

CLSANPTN 

00135 

BLIPBLIPBLIP 

-This shows that 6 seconds cf 

CLSANPTN 

00136 



CPU time have elapsed during 

CLSANPTN 

00137 



the assembly. 
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CLSAMPTM 

00141 

♦ASSEMBLES DONE 



CLSAMPTM 

00145 

#NO ‘STATEMENTS FLAGGED IN 

THIS ASSEMBLY 

CLSAMPTM 

00147 

h; 




CLSAMPTM 

n 0 1 50 

list file 

testprog * 

* 

-Information cn all files with 

CLSAMPTM 

00150 




a filename of TESTPROG is tc 

CLSAMPTM 

00151 




be typed 

CLSAMPTM 

00154 

PILENAME 

PIL ETYPB 

FMODB 


CLSAMPTM 

00155 

TESTPEOG 

ASSEMBLE 

A1 

-source statements 

CLSAMPTN 

00156 

TESTPBOG 

LISTING 

A1 

-listing of program 

CLSAMPTN 

00157 

TESTPHOG 

TEXT 

A1 

-object code 

CLSAMPTM 

00159 

R; 




CLSAMPTM 

00163 

print testprog listing 

-The listing of source 

CLSAMPTN 

00164 




statements# generated object 

CLSAMPTM 

00164 




code and diagnostic messages 

CLSAMPTM 

00164 




is to be spooled to the 

CLSAMPTM 

00165 




printer 

CLSAMPTM 

00168 

R; 




CLSAMPTM 

00170 

load testprog 


-The file TESTPROG TEXT which 

CLSAMPTM 

00170 




contains the object code 

CLSAMPTM 

00170 




created by the ASSEMBLE 

CLSAMPTM 

00171 




command is to be loaded into 

CLSAMPTM 

00172 




storage 

CLSAMPTM 

00175 

R» 




CLSAMPTM 

00177 

genaod testprog 


-An absolute image file is to 

CLSAMPTM 

00178 




be created using all 

CLSAMPTM 

00178 




currently loaded code. The 

CLSAMPTM 

00179 




filename will be TESTPECG 

CLSAMPTM 

00180 




MODULE A1 

CLSAMPTM 

00183 

R; 




CLSAMPTM 

° 018 5 

list file 

testprog * 

* 

-Information or. all files with 

CLSAMPTM 

00186 




a filename of TESTPEOG is to 

CLSAMPTM 

00187 




be typed at tke terminal 

CLSAMPTM 

00190 

FILENAME 

FILETYPE 

FMODE 


CLSAMPTM 

"^191 

TESTPHOG 

ASSEMBLE 

A1 

-source statements 

CLSAMPTM 

^0192 

TESTPBOG 

LISTING 

A1 

-listing of program 

CLSAMPTM 

n 9193 

TESTPROG 

TEXT 

At 

-object code 

CLSAMPTM 

00194 

TESTPHOG 

MODULE 

A 1 

-load module file 

CLSAMPTM 

00199 

r; 




CLSAMPTM 

"0202 

nodaap testprog 


-The user wishes to type the 
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CLSANPTN 

CLSAHPTN 

CLSAHPTN 

CLSAHPTN 

CLSAHPTN 

CLSANPTN 
C LSAHPTN 

CLSAHPTN 

CLSANPTN 

CLSAHPTN 

CLSAHPTN 

CLSAHPTN 

CLSAHPTN 

CLSAHPTN 

CLSANPTN 

CLSANPTN 

CLSANPTN 

CLSAHPTN 

CLSANPTN 

CLSANPTN 

CLSANPTN 

CLSAHPTN 

CLSANPTN 

CLSAHPTN 

CLSAHPTN 

CLSANPTN 

CLSANPTN 

CLSANPTN 

CLSANPTN 

CLSAHPTN 


CLSANPTN 

CLSANPTN 

CLSANPTN 

CLSANPTN 

CLSAHPTN 

CLSANPTN 

CLSANPTN 

CLSANPTN 


00203 


contents of the LCACFAF file 

00207 

00208 

00209 

TESTPBOG 20000 

SUSBBF 00600 

NUCON 00000 


00213 

R; 


00216 

00217 

loadaod test prog 

-The absolute iaage xodule is , 
to be brought intc storage 

00220 

H; 


00223 

"0224 

start 

-The loaded prcgran is tc 

begin execution 

00228 

00229 

EXECUTION BEGINS.. , 

-The prograx has begun 

execution 

00232 

00233 

"9234 

00235 

♦THIS IS OUTPUT OF A SANPLE 
********ASSEMBLES ********** 

********LANGUAGE*********** 
********PBOGHAH************ 

-output created by the prcgran 
which is executing 

"9239 

R; 


00241 

00242 

"9243 

type sortd exec 

-The specified file is tc be 
printed at the tersinal 

typewriter. 

00246 

♦EXAMPLE OF THE USE OF EXEC PBOCEDUBES 

00248 

00249 

00250 

00251 

00254 

00255 

00256 

00257 

00258 

♦THE FOLLOWING EXEC PROCEDURE WILL SOBT A GIVEN Fill IN 
♦DESCENDING ORDER AND EITHER CREATE A NEW FI IE CONTAINING 
♦THE SORTED OUTPUT OR REPLACE THE INPUT FILE WITH TEE 
♦ONE CONTAINING THE OSBTED OUTPUT. FORMAT OF INPUT COMMAND IS 
♦SORTD FN1 FT 1 FN1 (*H* j 

♦ (FN2 FT2 FN2) 

♦♦R* INDICATES THAT THE INPUT FILE IS TO BE FEPLACEE. IF 
♦FN2 FT2 FN2 IS SPECIFIED, THE SORTED OUTPUT IS PLACED 1NTC 
♦A FILE OF THAT NAME. 

00265 

00267 

6CONTBOL OFF 

-Suppress typing of CMS 

conaands as they are executed 

00270 

RENAME &1 62 63 SORTDOHN SISUT1 A1 

00272 

00273 

00274 


-Renane the input file to the 
file identifier expected in 
the conversion progran 

00278 

00278 

LOAD SORTDOHN (START 

-SCRTD0WN is a progran which 
converts every character in 
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CLSAMPTM 

00280 

CLSAMPTM 

00280 

CLSAMPTM 

00280 

CLSAMPTM 

00280 

CLSAMPTM 

00281 

CLSAMPTM 

00282 

CLSAMPTM 

00285 

CLSAMPTM 

00287 

CLSAMPTM 

00289 

CLSAMPTM 

00290 

CLSAMPTM 

00291 

CLSAMPTM 

00291 

CLSAMPTM 

00292 

CLSAMPTM 

00292 

CLSAMPTM 

00294 

CLSAMPTM 

00297 

CLSAMPTM 

00300 

CLSAMPTM 

00300 

CLSAMPTM 

00301 

CLSAMPTM 

00304 

CLSAMPTM 

00307 

CLSAMPTM 

00308 

CLSAMPTM 

00311 

CLSAMPTM 

00312 

CLSAMPTM 

00312 

CLSAMPTM 

00313 

CLSAMPTM 

00313 

CLSAMPTM 

00314 

CLSAMPTM 

00317 

CLSAMPTM 

90319 

CLSAMPTM 

00319 

CLSAMPTM 

00320 

CLSAMPTM 

00323 

CLSAMPTM 

00326 

CLSAMPTM 

00328 

CLSAMPTM 

00.329 

CLSAMPTM 

n 0329 

CLSAMPTM 

90330 

CLSAMPTM 

90333 


the file 
It uses a 
SYSUT1 as 
an output 
SYSUT2 
converted 


to its ccBflement. 
file named SOBTDCWN 
injrut and creates 
file named SCRTDOHN 
A1 containing the 
records. 


RENAHE SOBTDOHN SYSUT1 At 61 62 63 


SORT SORTDO0N STSUT2 A1 SOBTDOHN SYSUT1 A1 

-The standard SOBI supplied 
with CMS sorts a file into 
ascending order. Since every 
character in the file has 
been converted to its 
complement, the file will be 
sorted into descending order 


SBASE SOBTDOHN SYS0T2 A1 
LOAD SOBTDOHN (STABT 

ERASE SOBTDOHN SYSUT1 A1 
61F 64 NE *B* 6G0T0 -A 

ERASE 61 62 63 


-Each record in the sorted 
file is converted lac* to its 
original form 

-Erase work file 

-Determine if existing file is 
to be replaced 

-If existing file is to fce 
replaced, erase existing file 
and rename the work file 
containing the sorted records 
to the file identifier of the 
original file 


RENAME SOBTDOHN SYSUT2 Al 61 62 63 


-Rename the wcmiile 

containing the sorted file tc 
the original file identifier. 

6EXIT -Return to CMS 

-A RENAME SOBTDOHN SYSUT2 Al 65 66 

-Rename the wcrktile 

containing the sorted records 
to the specified new file 
identifier 


6EXIT 
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CLSANPTN 00.335 Bj 

CLSANPTN 00337 £x4I£l£ 2£ IL22 2£ Ii§ ££2£§4iM ££ 2 £edute 

CLSANPTN 00339 SORTD INPUTTO SOBT A1 OOTPUTFR SOBT A1 

-The comaad naie EXEC Deed 
not be entered. File INPUTTO 
SOBT A1 is to be sorted into 
descending order and the 
sorted output is to te placed 
in a new file naaed OUTtUTFfl 
SOBT A1 • 

CLSANPTN 00348 EXECUTION BEGINS... 

CLSANPTN 00350 DNSSBT604B ENTEB SOBT FIELDS: 

CLSANPTN 00352 30 34 

CLSANPTN 00354 EXECUTION BEGINS... 

CLSANPTN 00356 R; 

CLSANPTN 00359 SOBTD INPUTTO SOBT A1 *R* 

CLSANPTN 00359 
CLSANPTN 00359 
CLSANPTN 00361 

CLSANPTN 00364 EXECUTION BEGINS... 

CLSANPTN 00366 DNSSBT604B ENIEB SOBT FIELDS: 

CLSANPTN 00368 30 34 

CLSANPTN 00370 EXECUTION BEGINS... 

CLSANPTN 00372 H; 


CLSANPTN 00375 *This is an exaaple of the use of the LISTFILE ccnnand tc 

CLSANPTN 00376 *create an EXEC procedure. If the user has aary tiles 

CLSANPTN 00377 *with a filetype of ASSEHBLE which he warts punched so 

CLSANPTN 00378 *that he aay transfer then to another user, he coula do 

CLSANPTN 00380 *this in two ways: 

CLSANPTN 00382 *1. He could enter the connand: 

CLSANPTN 00384 * DISK DUMP filename ASSEHBLE 

CLSANPTN 03397 * for each file. This could be a very tine consuaing 

CLSANPTN 00389 * procedure if aany files are involved. 

CLSANPTN 00391 *2. He could eater the coaaand: 


-File INEUTTO £CBT A1 is to be 
sorted into descending crder 
and the sorted output is tc 
replace the original file. 


CLSANPTN ^*0342 
CLSANPTN 00343 
CLSANPTN 00343 
CLSANPTN 00344 
CLSANPTN 00344 
CLSANPTN 00344 
CLSANPTN OQ345 
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CLSAMPTM 

CLSAMPTM 


CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 

CLSAMPTM 
CLCOHP AT 


00393 LXSTFILE * ASSEMBLE * (EXEC) 

00395 R; 


00398 *This would create a file named CMS EXEC with records of 
09400 *the following format: 

00402 * SI 82 filename ASSEMBLE filemode 

00405 *One record will be created for each file with a filetype 
00406 *of ASSEMBLE. He could then execute the following command: 

00409 *CMS DISK DUMP 

00410 *which will substitute DISK for SI and DUMP for 62 

00411 *which creates a DISK DUMP command for each file. 

00413 ^Before doing this he issues a command tc indicate that 

00414 *all files in his virtual punch are to be transferred to 

A0415 *another user. 

00417 spool punch to jones 

00418 cms disk dump 


00421 

DISK DUMP PROS1 

ASSEMBLE 

A1 

-each command 

in the 

file 

00422 

PCH FILE 0001 to 

JONES 


CMS EXEC is 

printed 

as it 

00423 

DISK DUMP PROG2 

ASSEMBLE 

A1 

is executed. 

The line 

after 

00424 

PCH FILE 0002 TO 

JONES 


the command indicates 

that 

00425 

DISK DUMP PROG 3 

ASSEMBLE 

AT 

the file is 

now in 

the 

00426 

PCH FILE 0003 TO 

JONES 


virtual punch 

of user 

jcnes 

00427 

DISK DUMP PR0G4 

ASSEMBLE 

A1 

who may issue 

a DISK 

LC AC 

00428 

PCH FILE 0004 TO 

JONES 


command to restore it 

to a 

00429 

DISK DUMP PR0G5 

ASSEMBLE 

A 1 

disk file. 



00431 

PCH FILE 0005 TO 

JONES 





00434 

R; 






00437 

CLOSE PUNCH 



-the files are 

now gueued for 

00438 




input for user 

jones, 


00440 

logout 



-the user logs 

out from 

the CP 

00441 




system. 



00444 

CONNECT=00:20: 15 

VIRTCPU=03:56 

:20 TOTCEU=05:2 

0: 30 


0^001 

LOGOFF AT 13:47: 

11 EST FRIDAY 

04/13/72 
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CLCOHPAT 00005 


A££££&li £: £Q«£Ami£m °Z IOZ212. Mill! ZZzlll S£S 


CLCOHPAT 00007 
CLCOHPAT 00008 
CLCOHPAT 00009 
CLCOHPAT 00010 
CLCOHPAT 00"11 
CLCOHPAT 00012 
CLCOHPAT 00013 
CLCOHPAT 00014 
CLCOHPAT 00015 
CLCOHPAT 00016 


Certain coiaands faailiar to CP-67 users arc net supported 
in VH/370. The funct ions available under CP-67 do, however, 
have equivalents in VH/370 where appropriate. The following 
is a list of all CP-67 console functions, with operand 
variations, showing the incoapatibilities with VH/37C. 
Functions listed under CP-67 3.1 and net under VH/370 
indicated that the syntax and function are identical. There 
are, of course, additional functions available with the 
VH/370 coaaands, as shown in the "Ccaxands" section cf this 
book. 


CLCOHPAT 

00019 

Status? 

A - CP/67 

CLCOHPAT 

00022 


R - CP/67 

CLCOHPAT 

00022 



CLCOHPAT 

"0023 



CLCOHPAT 

C 7925 


M - CP/67 

CLCOHPAT 

77026 




Syntax accepted in VH/370 
Syntax not accepted - Functionally 
supported by another comaacd 
for sat. 

Syntax not accepted - function net 
supported in VH/370. 


CLCOHPAT 

CLCOHPAT 

CLCOHPAT 

CLCOHPAT 

CLCOHPAT 

CLCOHPAT 

CLCOHPAT 

CLCOHPAT 

CLCOHPAT 

CLCOHPAT 

CLCOHPAT 

CLCOHPAT 

CLCOHPAT 

CLCOHPAT 

CLCOHPAT 

CLCOHPAT 

CLCOHPAT 

CLCOHPAT 

CLCOHPAT 

CLCOHPAT 

CLCOHPAT 

CLCOHPAT 


00039 
0 7040 
0 794 1 
00^42 
00043 
0 0044 
00045 
00046 
00047 
0Q048 
00049 
00050 
00051 
00052 
00053 
0 00 54 
00055 
00056 
00057 
9 0"58 
00059 
00O60 


IStatusj CP/67 Coaaand 


| VH/370 Equivalent 


R | ACMT 

I 

A (ATTACH cuu TO (STSTEHJ AS (Volid} 
I (userid) (vaddr} 

I 

A |BEGIN 

A | BEGIN hexloc . 

I 

A (DCP hexloc1(-hexloc2 ] 

A | DCP Lhexloc 1(-hexloc2 j 
A | DCP Thexloc1[-hexloc2 } 

I 

A (DETACH vaddr 0 

s I DETACH raddr 

I 

I 

A |DIAL systea 

I 


ACNT AIL 


D FT AC H raddr FFCd (SfSILilj 
(userid} 




CLCOHPAT 00064 


Figure 41. VH/370 Coapatibility with CP-67 (lart 1 cf 5) 
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CLCOMPAT 

00067 


-- 



| \)M/370 Eguivalent 

1 

CLCOMPAT 

CLCOMPAT 

00068 

00069 

jstatusl CP/67 

Coaaand 


1 


, i 




CLCOMPAT 

00070 

1 

N 

|DIRECT LOCK 

i 


CLCOMPAT 

00071 

1 

N 

jDIRECT DNLOCK 



CLCOMPAT 

00072 

1 


I 


1 


CLCOMPAT 

n0"73 

1 

A 

|DISABLE 

line 

1 


CLCOMPAT 

00074 

1 

A 

|DISABLE 

ALL 

1 


CLCOMPAT 

00075 

1 


1 


1 


CLCOMPAT 

o 0076 

1 

A 

|DISCONN 




CLCOMPAT 

00077 

1 

B 

|DISCONN 

XXX 

|D ISCO AN HOLD 


CLCOMPAT 

00078 

1 


1 




CLCOMPAT 

00079 

1 

A 

|DISPLAY 

hexlocl [-hexloc2J 

1 r t 


CLCOMPAT 

00080 

1 

R 

|DISPLAY 

L[ —hexloc2 ] 

|DISPLAY I0|—hexloc2| 


CLCOMPAT 

00081 

1 

A 

|DISPLAY 

Lhexloc1[-hexloc2] 

| l-ENC I 


CLCOMPAT 

00002 

1 


1 




CLCOMPAT 

00083 

1 


1 


I r t 


CLCOMPAT 

00084 

i 

B 

|DISPLAY 

T[ -hexloc2] 

|DISPLAY TO|—hexloc2| 


CLCOMPAT 

00085 


A 

|DISPLAY 

Thexloc 1[-hexloc 2] 

| J-lND I 


CLCOMPAT 

00086 

1 


1 


1 L J 


CLCOMPAT 

0 O087 

1 


1 


1 r t 


CLCOMPAT 

00089 

1 

B 

|DISPLAY 

K[-hexloc2 ] 

IDISfLAY K0|-hexloc2| 


CLCOMPAT 

00089 

1 

A 

|DISPLAY 

Khexloc1[-hexloc2] 

| l-END | 


CLCOMPAT 

00090 

1 


1 


i L J 


CLCOMPAT 

00091 

1 


1 




CLCOMPAT 

00092 

1 

A 

1 DISPLAY 

G[ -reg2 ] 

l 


CLCOMPAT 

0 0093 

1 

A 

|DISPLAY 

Gr eg[—reg2 J 



CLCOMPAT 

00094 

1 


1 




CLCOMPAT 

00095 

1 




l 


CLCOMPAT 

00096 


A 

|DISPLAY 

Y[ -reg2 ] 



CLCOMPAT 

00097 


A 

|DISPLAY 

Yreg[ -reg2 ] 



CLCOMPAT 

0 O098 

1 


1 




CLCOMPAT 

AOP99 



1 




CLCOMPAT 

O0100 

1 

A 

|DISPLAY 

X[ -reg2 ] 

l 


CLCOMPAT 

O0101 

1 

A 

|DISPLAY 

Xreg[-reg2 ] 

l 


CLCOMPAT 

00102 

\ 


1 


l 


CLCOMPAT 

00103 

i 

A 

| DISPLAY 

PSM 



CLCOMPAT 

00104 

1 


\ 


l 


CLCOMPAT 

00105 

1 

A 

|DHCP hexloc1[-hexloc2 ] 

1 r i 


CLCOMPAT 

0 9106 

1 

R 

| DMCP L[ 

-hexloc2 ] 

JDECE LC |-nexj.oc2 | 


CLCOMPAT 

00107 

1 

A 

| DHCP Lhexloc1[-hexloc2 ] 

| 1-END | 


CLCOMPAT 

00108 

1 


1 


1 1 J 


CLCOMPAT 

00109 



S 


1 r t 


CLCOMPAT 

00110 

1 

B 

1DMCP T[ 

-hexloc2 1 

|DMCP 10|-hexloc5| 


CLCOMPAT 

o 0111 

1 

A 

1 DHCP Thexloc1[ -hexloc2 ] 

| l-END | 


CLCOMPAT 

00112 

1 


1 


1 1 J 


CLCOMPAT 

00113 

1 


1 


1 


CLCOMPAT 

O0115 

1 

A 

|DRAIN 




CLCOMPAT 

OQ116 

1 


1 


1 


CLCOMPAT 

00117 

1 

N 

jd o_a p 


1 


CLCOMPAT 

CLCOMPAT 

00118 

o 0120 






J 

Figure 

41, Compatibility of VM/370 

with CP-67 (Part 2 ct 5) 



) 
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00293 ;qcomp atibi lity &l 3 L£em§.at to ££-6ZZ££S £§e£§ 


00294 Although tha CMS in VN/370 is built upon CMS Veision 3.1 in 
00295 CP-67/CMS, there are five types of modifications that were 
00297 iade to 3.1 that affect the relationship between versions: 


00301 1. Unchanged: soae commands and system functions remain 

00302 unchanged; therefore, complete compatibility exists. 


00306 

00306 

00307 

00308 


2. Additional Functional capability: functional and 

syntactical enhancements have been effected; but, in 
some cases, old keywords and functions will te 
supported. 


00311 
0 0 312 
00313 


3. Command Name Alterations: where commands have- 

undergone name changes, a SYNONYM file may be included 
during nucleus system generation. 


00316 4. Keyword Changes: some keywords within a command have 

00317 been modified, deleted or added. 


00320 5. Major Modifications: improvements tc commands and 
00320 system functions have caused complete incompatibilities 
00321 in the following areas: 


00325 
00326 
n 0327 


• Because the CMS nucleus is significantly larger, 
all MODULES must be recreated frcir their object 
(TEXT) files using the GENMOD command. 


00329 
00330 
"9331 
00332 
0 0332 
00333 
00334 


Because the user may now have up to 1C disks, the 
logical directory identifications (filemcde 
letters) have been changed to reflect a more 
"natural", easy-to-remember, search cider: F, I, 
A, B, S, C becomes A, B, C, D, E, F, G, S, Y, Z - 
with the system disk being the £ disk, and the 
primary disk becoming the A disk. 
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00337 


• The following global changes of filetypes must be 
made: 


00339 

00341 


SYSIN to ASSEMBLE 
ASP 360 to MACRO 


00343 

00345 

00346 

00347 

00348 

00349 


• For language processors, the DECK/hODECK has a new 
meaning, that is, route the object (TEXT) tile to 
the spooled card punch; the IQ££/NCL0AD option new 
invokes the function formerly performed by 
DECK/NODECK, that is, the writing c t the TEXT file 
to a CMS disk* 


00351 

''9352 


• No 2311 disk support is provided for CE cc CMS 
files. 
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In Version 1.0 the tape desigraticns are as 
follows: 

TAPI is for 181 

TAP2 is for 182 

The default for tape commands is TAF1. 
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might have to be reasseabl9d and then regenerated. 

00380 

• 

SYSLIB MACLIB has been renamed to CftSLIE t'ACLIE. 

00382 

00383 

00384 

00385 

"0387 

00388 

00389 

0 
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changed to conform to Vtf/370 CMS. Magor cnanges 
are: 
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&INDEX0 to 6SETC0DE 
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Options specified for a LOAD command do net remain 
in effect for subsequent INCLUDE commands; options 
are reset to default settings unless the SAME 
option is specified. 
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Filenames and filetypes must be composed entirely 
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If the CMS VI.0 system does net recognize a 
command name, the command line is automatically 
passed to CP. If the CMS SET anc *UERY commands 
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do not recognize a parameter, the command line is 
passed to CP. This is net true for EXEC files; 
the CP command must be explicitly stated. The 
feature may be negated by entering the command: 

SET IHPCP OFF 
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each CP-67/CHS command foe VH/37C CMS: 


command naie changed to BENAME. 

Components of the new file identifier may not be 
specified as asterisk(*) . An egual sign(=T 
performs sane function. 

NOOP option keyword changed to NOUPDIBT; NOUP 
the abbreviation. 

Default options added: NOTYPE, UEDIRT. 


only one file nay be assenblcd per ASSEMBLE 
coaaand. 
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Qp ti ons Chang ed: 

NODECK is the default 

DliGJNODIAG changed to 15551 NOTESH 

LTAPn not supported 

LDISK option naae changed to CISK 

flptjons_Adjg4: 

NOLOAD, iiGNINOALGN 
251 DOS, TEST|fi2IBSI# LINECT nnijjS, 

525IMOMOH, STMT|525152 


functionally supported by SET BLIP. 

not implemented. 

functionally supported by EDIT. 

functionally supported by CP TERMINAL CHABDEF 
coaaand. 

functionally supported by the CP commands, SPCCL 
and CLOSE. 

functionally supported by SVCTRACE CEE command. 

functionally supported by COPYF31E command with 
EBCDIC option. 

functionally supported by C0PYFI1E. 
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If syabol specified* length of field 
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defaults tc 
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no change. 
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function not supported. 
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functionally supported by TYPE command with HEX 
option. 
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functionally supported by DDR cosmand. 
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functionally supported by CP coonand ECLO. 
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CLCHSPAT 

CLCHSPAT 

00156 

00158 

00160 

mil 

filename must be specified, 
fileaode may be specified. 

LRECL may be specified for a new file. 

CLCHSPAT 
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mn sgasQi 

!MN£S 

CLCHSPAT 

CLCHSPAT 

00165 

00166 

BACKSPACE 

functionally supported by CHE command, SET 

INPUT. 

CLCHSPAT 

00169 

BLANK 

functionally supported by OVERLAY. 

CLCHSPAT 

0 0171 

BOTTOH 

no change. 

CLCHSPAT 

00174 

BRIEF 

function accomplished by VERIFY cff request. 

:lchspat 

P0177 

CHANGE 

no change. 

CLCHSPAT 

CLCHSPAT 

00180 

^"182 

DELETE 

/string/ is not valid as an operand. 

* may be used to delete to end cf file. 

CLCHSPAT 

00185 

FILE 

filetype and filemode may be specified. 

CLCHSPAT 

n 0187 

FIND 

no change. 

CLCHSPAT 

00189 

INPUT 

no change. 

CLCHSPAT 

00191 

INSERT 

functionally supported by INPUT iecuest. 

CLCKSPAT 

00193 

LOCATE 

no change. 

CLCHSPAT 
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NEXT 

no change. 

CLCHSPAT 
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OVERLAY 

no change. 

CLCHSPAT 

CLCHSPAT 

CLCHSPAT 

00200 

0 0203 

0 0 204 

PRINT 

request name changed to TYPE. 

* may be specified to indicate that typing is 
to continue until EOF. 
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Instead of L in second field, * is specified. 

CLCMSPAT 

00210 

QUIT 

no change. 

CLCMSPAT 

00213 

REPEAT 

valid only for subsequent OVERLAY request. 

CLCMSPAT 

00216 


* aay be specified as first operand tc indicate 

CLCMSPAT 

00217 


that the OVERLAY request is to fce repeated 

CLCMSPAT 

00218 


for the reaainder of the file. 

CLCMSPAT 

C"221 

RETYPE 

request naae changed to REPLACE. 

CLCMSPAT 

00223 

SAVE 

filetype and fileaode nay be specified. 

CLCMSPAT 

00226 

SERIAL 

first operand changed to 

CLCMSPAT 

00228 


{OFF| • seq* (saae as ID)|ON|ALL). 

CLCMSPAT 

00231 

TABDEF 

functionally supported by CMS ccauand SET INPUT. 

CLCMSPAT 

00234 

TABSET 

no change. 

CLCMSPAT 

"0236 

TOP 

no change. 

CLCMSPAT 

"0238 

UP 

no change. 

CLCMSPAT 

00240 

VERIFY 

operand foraat changed; function added. 

CLCMSPAT 

00242 

X 

no change. 

CLCMSPAT 

00244 

Y 

no change. 

CLCMSPAT 

"0246 

ZONE 

no change. 

CLCMSPAT 

00249 

£1M£ 

default option added; old foraat accepted. 

CLCMSPAT 

"0251 


* * * not supported. 

CLCMSPAT 

00254 


no change. 

CLCMSPAT 

00256 

EX EC _Control, Words 

CLCMSPAT 

"0258 

6ERROR 

action does not default to 6C0NT1MJE. 

CLCMSPAT 

0 026) 

GIF 

no change. 

CLCMSPAT 

00262 

GEXIT 

no change. 

CLCMSPAT 

"0264 

GQ0IT 

functionally supported by GEXIT C» 

CLCMSPAT 

00266 

GSKIP 

no change. 

CLCMSPAT 

00269 

6GOTO 

EXIT not supported as operand. 

CLCMSPAT 

00271 


line-nuaber now a valid operand. 
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SLOOP 

no change. 

CLCMSPAT 

00276 

SCONTIN0E 

no change. 

CLCHSPAT 
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6TYPE0UT 

functionally supported by GCCNTRCL ccctrol sor'd; 

CLCMSPAT 
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ON, NOEXEC, RESUME, KILL not valid. 

CLCMSPAT 

00282 


CMS operand added. 

CLCMSPAT 

00285 


r i r -i 

CLCMSPAT 

00287 


JON | |RESET| 

CLCMSPAT 

00289 

STIME 

operands changed to |0££| I TYPE j. 

CLCMSPAT 

00291 


L J L J 

CLCMSPAT 

00293 

6SPACE 

no change. 

CLCMSPAT 

00295 

SPHINT 

functionally supported by STYPE. 

CLCMSPAT 

00297 

GUPRINT 

functionally supported by GBEGTYEE. 

CLCMSPAT 

00299 

GPUNCH 

no change. 

CLCMSPAT 

00301 

GOPUNCH 

functionally supported by GBEGPUKCH, 

CLCMSPAT 

00303 

GCOMHENT 

functionally supported by * card. 

CLCMSPAT 

00305 

GAHGS 

no change. 

CLCMSPAT 

00307 

GREAD 

VARS operand added. 

CLCMSPAT 

00309 

GSTACK 

no change. 

CLCMSPAT 

00311 

, GBEGSTACK 

ALL operand added. 

CLCMSPAT 

00313 

SENDSTACK 

functionally supported by SEND. 

CLCMSPAT 

00315 

GSET 

not iaplemented. 

CLCHSPAT 

00319 

£IUm 

device nanes changed: con-TERMIEA l 

CLCMSPAT 

00321 


DSK—DISK 

CLCMSPAT 

00323 


DSK-nn—not supported 

CLCMSPAT 

00325 


DUMMY-no change. 

CLCMSPAT 

00327 


PFT—PRINT ER 

CLCMSPAT 

00329 


PUN-PUNCH 

CLCMSPAT 

0 03 31 


RDR-READER 

CLCMSPAT 

^ 0 3 3 3 


TAPEn-unchange d 

CLCMSPAT 

p 3335 


BAT-not supported 

CLCHSPAT 

00340 

ii ms 

not supported froa terminal. 

CLCHSPAT 

00343 

I2U3II 

all functions supported; all operands changed. 

CLCMSPAT 

00346 

ZQU&M 

This coaaand is now supported fcy the commands 
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CLCHSPAT 

CLCHSPAT 

CLCHSPAT 

CLCHSPAT 

CLCHSPAT 

CLCHSPAT 

CLCHSPAT 

CLCHSPAT 

CLCHSPAT 

CLCHSPAT 

CLCHSPAT 

CLCHSPAT 

CLCHSPAT 

CLCHSPAT 

CLCHSPAT 

CLCHSPAT 

CLCHSPAT 

CLCHSPAT 

CLCHSPAT 

CLCHSPAT 

CLCHSPAT 

CLCHSPAT 

CLCHSPAT 
CLCHSPAT 
CLCHSPAT 
CLCMSP AT 
CLCHSPAT 
CLCHSPAT 
CLCHSPAT 
CLCHSPAT 
CLCHSPAT 
CLCHSPAT 
CLCHSPAT 
CLCHSPAT 
CLCHSPAT 
CLCHSPAT 
CLCHSPAT 
CLCHSPAT 


CLCHSPAT 

CLCHSPAT 

CLCHSPAT 

CLCHSPAT 

CLCHSPAT 


00346 


F0HTG1 , FORTHX, GOFORT, and CONVJEI which invoke 

00347 


IBM Program Products, 

00349 


incompatible; positional parameters and options 

00351 


changed; equivalent function performed. 

00354 


PRINT function removed; others compatible. 

00356 

Hit 

not explicitly supported in CMS; however, the 

00357 


command may be issued and will te parsed tc tne 

00358 


Control Program for processing. 

00359 


either a device address or system naie must be 

00360 


specified, 

00362 


cyl-no may be specified. 

00364 


Options afldgfl: CLEAR 1NOCLEAR. 

00366 

U 

functionally supported by tie CP command 

00367 


TERMINAL LINESIZE nn. 

00370 

KO 

command name changed to HO, 

00372 

KT 

command name changed to HT. 

00374 

KX 

command name changed to HX. 

00376 


functionally supported by the Ct command 

""377 


TERMINAL LINEND. 

00379 

1ISII 

command name changed to L1STF1LE; LIST F 

00380 


accepted. 

00385 


Option Changes: 

00387 


SORT— option not implemented. 

"0388 


ITEM- option not implemented; ALLCC option 

"0389 


produces both logical records and 

"0390 


blocks. 

"0392 


NAME- option name changed tc FNAHE. 

"0394 


TYPE- option name changed tc FTYFi. 

00396 


MODE- option name changed tc FMOCE• 

"0398 


REC- supported by ALLOC option. 

"0400 


DATE— produces mm/dd/yy ah: be. 

00UC1 


YEAR- not implemented; functionally 

00402 


supported by DATE option. 

00403 


TIME- not implemented; functionally 

"0404 


supported by DATE option. 

"0406 


LABEL and FORHAT options added. 

00408 


APPEND option added. 

""410 


HEADER]NOHEADER option added. 

00415 

Afi 

k3&iL§s: 

00419 


SLCxxxxxx-option changed to OFIGIN xxxxxx. 

"0420 


SLC12000-default changed to first available 

00421 


location. 

00423 


SINT—option name changed to NCINV, 
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CLCMSPAT 00425 
CLCMSPAT 00427 
CLCMSPAT 00429 
CLCMSPAT 00431 
CLCMSPAT 00433 
CLCMSPAT 00435 
CLCMSPAT 00437 
CLCMSPAT 00439 


PINV-option 

name 

ch anged 

to 

IFV. 

SREP-option 

name 

changed 

to 

NCR EP. 

PREP-option 

name 

changed 

to 

REP. 


SLIBE-option name changed to fcCLItl. 
SAUTO-option name changed to KOAUTO. 
XEQ-option name changed to START. 

NOXEQ—option not supported. 
options adde d: RESET. 


CLCMSPAT 00441 
CLCMSPAT 00442 
CLCMSPAT 00443 


TXTLIB files may no longer be specified in a 
LOAD command, but must have teen previously 
specified by a GLOBAL command. 


CLCMSPAT 00447 ISIDflflfi 


filetype must be specified if filemode is given. 


CLCMSPAT 00450 LOGI N 
CLCMSPAT 00451 
CLCMSPAT 00453 
CLCMSPAT 00455 
CLCMSPAT 00456 
CLCMSPAT 00458 
CLCMSPAT 00460 


functionally supported by ACCESS command, 
comma between mode and extdisk replaced with 
slash (/); extdisk optional. 

Opti on s: 

NOPBOF-option supported. 

NOTYPE—option not supported. 

NO-OFD-option name changed to ERASE. 


CLCMSPAT 00463 lfOGOO£ 


functionally supported by CP comaand ICG0UT < 


CLCMSPAT 

CLCMSPAT 

00465 

00466 

M££il 

functionally supported by i 
PRINT. 

CMS 

commands TYPE or 

CLCMSPAT 

00469 

M0I2MP 

no change. 





CLCMSPAT 

00472 

omiiLE 

READ 

functionally 

supported 

by 

REAECARD command. 

CLCMSPAT 

00474 

OFFLINE 

PRINT 

functionally 

supported 

by 

PFINT 

ccindiia. 

CLCMSPAT 

00476 


PRINTCC 

f unct ionally 

supported 

by 

PRINT 

command. 

CLCMSPAT 

00478 

omiiLs 

PRINTUPC 

functionally 

supported 

by 

PRINT 

command. 

CLCMSPAT 

00480 

omms 

PONCH 

functionally 

supported 

by 

PtiNCH 

c cb raand. 

CLCMSPAT 

00482 

2E£iIii£ 

PONCHCC 

functionally 

supported 

by 

PCNCH 

ccn manoo 

CLCMSPAT 

00484 

2EEUJLS 

PUNCHDT 

functionally 

supported 

by 

PINCH 

ccmaana. 


CLCMSPAT 00487 


05.IAU 


command name changed to TAPPES, 
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CLCHSPAT 

00489 

m 

This command is now supported by the command 

CLCMSPAT 

00491 


PLIOPT which invoices an IBH Program Eroauct. 

CLCHSPAT 

00494 

mm 

command name changed to TYPE. 

CLCHSPAT 

0 0496 


fileaode may be specified. 

CLCHSPAT 

00498 


n3 functionally supported by COL cpticr. 

CLCHSPAT 

00500 


Options added: HEX# HEMBER. 

CLCHSPAT 

00503 

S£ ILhM 

DET option not implemented although functionally 

CLCHSPAT 

C05C4 


supported by the CP command DETACH. 

CLCHSPAT 

00507 

&S2SS 

command name changed to INCLUDE. 

CLCHSPAT 

00509 


option differences are the same as for LOAD. 

CLCHSPAT 

00510 


TXTLIB files may no longer be specified in the 

CLCHSPAT 

00511 


command; but must have been previously specified 

CLCHSPAT 

00512 


by a GLOBAL command. 

CLCHSPAT 

00515 

SI 

no change. 

CLCHSPAT 

00518 

scsi £1 

not implemented. 

CLCHSPAT 

00520 

SElfiHR 

functionally supported by SVCTRACE CN. 

CLCHSPAT 

00522 

SETOV1R 

functionally supported by SVCTFACE CN. 

CLCHSPAT 

00524 

SNQfiQL 

not implemented. 

CLCHSPAT 

00527 

SO ST 

filemode must be specified for both input and 

CLCHSPAT 

00528 


output files. 

CLCHSPAT 

00531 

SPill 

functionally supported by COPYF11E commend. 

CLCHSPAT 

00533 

START 

(NO) operand not valid. 

CLCHSPAT 

00535 

SIAI 

functionally supported by'CUERY command. 

CLCHSPAT 

00537 

SIAI£ 

no change. 

CLCHSPAT 

00539 

2X1! 

command name changed to SYNONYM; SYN minimum 

CLCHSPAT 

00540 


truncation* 

CLCHSPAT 

50543 


filetype must be SYNONYM* 
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CLCMSPAT 

00545 


CLCMSP AT 

00547 


CLCMSPAT 

0 0549 


CLCMSPAT 

00553 

IhlS 

CLCMSPAT 

00554 


CLCMSPAT 

00555 


CLCMSPAT 

00559 


CLCMSPAT 

00562 


CLCMSPAT 

00563 


CLCMSPAT 

00567 

IA££ DUMP 

CLCMSPAT 

00572 

1AEE LOAD 

CLCMSPAT 

00574 


CLCMSPAT 

00577 


CLCMSPAT 

00579 


CLCMSPAT 

00583 

2A£E scan 

CLCMSPAT 

00505 


CLCMSPAT 

00587 


CLCMSPAT 

00589 


CLCMSPAT 

00592 

2AE£ skip 

CLCMSPAT 

00595 

SLOAD 

CLCMSPAT 

00597 


CLCMSPAT 

00600 

UlSIQ 

CLCMSPAT 

00603 

Xkil&S 

CLCMSPAT 

00605 


CLCMSPAT 

00607 


CLCMSPAT 

00609 


CLCMSPAT 

00611 


CLCMSPAT 

00613 


CLCMSPAT 

00615 


CLCMSPAT 

0 0617 


CLCMSPAT 

00620 

UIRM1 

CLCMSPAT 

00624 

1PCQSX 

CLCMSPAT 

00627 

unis 

CLCMSPAT 

00628 


CLCMSPAT 

00632 

MUXS 

CLCMSPAT 

00634 


:lcmspat 

^^636 



O£t±oas: 

SYMONYM command with P and PISEK options is 
functionally supported by QUEFY SYNCFYM. 


TAPn aay also be specified by a virtual address. 
«n" options after SCAN, SKIP, SLCAC, replaced ty 
•EOF n*. 

2ptians_aided: 7TRACK|9TRACK, DEK, TRICE . 

Function s ad ded: MODESET, BSF, PSR, ERG, FSF, 
FSR, R0 n7**REW. 

OptionS_added: WTMJNOW1M, NOPRINl|PRINTIIERMJDISK. 

functionally supported by TAPE LCAD ECFr,. 
file identifiers nay be specified. 

O£jy,oas_ldded: NOPRINTI PHI NT | £££E| BISK , 
E0Fn|E0T7l0£i. 

filename and filetype aay be specified, 
functionally supported by 1APE SCAN (EOF n). 

NOPRINT J PRINT ilEJ?R|EISK, 

EOF n JEOtJIoFJ. 

comments sane as for TAPE SCAN. 

functionally supported by TAPE LCAE fn ft. 
filemode may be specified. 

functionally supported by TAPE. 

default filename is TAPPOS for NCED3 option, 
default filetype is CMSUT1. 

Option Cha n ges : 

NPDS - option name changed tc NOPDS. 

NCOLI - option name changed tc NGCCLI. 

TAPx — default is TAPI. 

NEND - option name changed to NOEKD. 

NMAXTEN - option name changed tc KCMAX1EN. 

functionally supported Dy MOVEF1IE ccnraand. 


functionally supported by MOVEFILE ccrmand. 


PRINT and LIST functions supported by NAt 
function. 


2££i2a.£M&3£s: 

P - option name chanyed to REE. 

default options adiod NCREP, KCSEC6, NCiNc. 
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CLCMSPAT 00639 

CLCMSPAT 00640 
CLCMSPAT 00641 


functionally supported by INCLUEE ccmrand vitn 
the SAME option. See discussion c£ REUSE 
compatibility. 


CLCMSPAT 

00644 

15 £2 

command name 

changed to SET. 

CLCMSPAT 

00650 


functions: 


CLCMSPAT 

00652 


BLIP 

ON aay be specified tc return to 

CLCMSPAT 

"1653 



default 

CLCMSPAT 

01655 


CHARDEF 

functionally supported fc> CP 

CLCMSPAT 

"1657 



coaaand TERMINAL! {CfcAHDEL|IINEDEL|ESCAPE} 

CLCMSPAT 

00661 


IMP EX 

no change. 

CLCMSPAT 

00663 


LDRTBLS 

no change. 

CLCMSPAT 

00664 


LIN END 

functionally supported ty CP 

CLCMSPAT 

00666 



coaaand TERMINAL LINEND. 

CLCMSPAT 

00668 


RDYMSG 

(2N|OFF changed to LPSG|S«5£. 

CLCMSPAT 

00670 


BEDTYPE 

no change. 

CLCMSPAT 

"0672 


RELPAGE 

no change. 

CLCMSPAT 

00673 


Eafifitiaas-aidad** input, output, inoei, abbhev. 

CLCMSPAT 

00674 


IMPCP. 



CLCMSPAT 

CLCMSPAT 

00678 

00680 

IB IhU 

functionally supported 
MOVEFILE cooaand. 

ty 

TAPE cciaand cr 

CLCMSPAT 

CLCMSPAT 

00683 

"0685 

I 

coaaand naae 
filetype and 

changed to RUN. 
filenode aay be 

specified. 


CLCMSPAT O0686 
CLCMSPAT O0687 
CLCMSPAT 00688 


files nay also have filetypes in addition to 
EXEC, NODDLE, and TEXT of those tsed by the 
language processors for input. 
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CLPROGPR 


CLPROGPR 

CLPROGPR 

CLPROGPR 

CLPROGPR 

CLPROGPR 

CLPROGPR 

CLPROGPR 

CLPROGPR 

CLPROGPR 

CLPROGPR 

CLPROGPR 

CLPROGPR 

CLPROGPR 

CLPROGPR 

CLPROGPR 

CLPROGPR 

CLPROGPR 

CLPROGPR 

CLPROGPR 

CLPROGPR 

CLPROGPR 

CLPROGPR 


00007 imam & r&qmqis. lmqmmizu 


^ 0009 

oooto 

0 0C11 
00°12 


Certain functions referred td in this publication are 
provided through IBM Program Products, which are available 
from IBM for a license fee. Program Products referred to in 
this manual are: 


00017 

00018 

00020 


Full American National Standard COBCL Version 4. See the 
Publication: IBM Victual J3a£iiin§. Fac i lit v/37C, CCBCL 
Pr ogramm er* s Guide {Order No. GC20-1dxx-x). 


00023 

00024 

00025 


PL/I Optimizing Compiler. See the publication: IBM 
V i rtua l Machine P acility/3 70 pl/ 1 Proc^am roei^s Guide 
(Order No. GC20-18xx-x) . 


00028 

00^28 

00030 

00031 


« FORTRAN (G1) . A version of the FORTH A h (G) ccmpiler 
suitable for the terminal environment. See the 
publication: IBM Virtual Machine Facilit y/3 7C 

FO RTRAN P roqram mer* s Guide (Order No. GC2C- 13*x-xxx—x) . 


00034 

00034 

00036 

00037 


FORTRAN (HX) . A version of the FORTRAN (G) compiler 
suitable for the terminal environment. See the 
publication: XBM Virt ual Mac hin e Fugjllty/370 3_7_0 
FORTRAN P rogrammer * s Guide (Order No. Go. GC2C-1bxx—x). 


00040 

00041 

00043 

00044 


• Code and GO FORTRAN. A PORTRAN compiler designed for 
very fast compile-execute sequence. See the Publication: 

ISA lima 1 flas^ias tasiliii^izo zonzuit matatsjsis 

Guide (Order No. GC20-13xx-x). 
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CLHIMTRU 00006 A£££N£IA fl: XBU££AII12ii5 £2JL.£fl§ i2fli3iiLD MBES 


CLMIN T R r J 

00008 

SYSTEM 

SHORTEST 

CLHINTRtJ 

00010 

COMMANg 

£Oj£fJ_ 

CLHINTRO 

00C12 

ASSEMBLE 

A 

CLHINTRO 

00013 

ACCESS 

AC 

CLHINTRO 

00014 

BASIC 

3& 

CLHINTRO 

C 001 5 

COMPARE 

COM 

CLHINTRO 

00016 

COPY FILE 

COPY 

CLHINTRO 

*0017 

EDIT 

2 

CLHINTRO 

00018 

EXEC 

EX 

CLHINTRO 

00019 

FILED EF 

PI 

CLHINTRO 

00020 

GENMOD 

G 

CLHINTRO 

00021 

GLOBAL 

GL 

CLHINTRO 

00022 

INCLUDE 

IN 

CLHINTRO 

00023 

LISTP ILE 

L 

CLMINTRO 

0 00 24 

LOADNOD 

LOADM 

CLMINTRO 

*0025 

MACLIB 

MAC 

CLMINTRO 

00026 

MODMAP 

MOD 

CLMINTRO 

00027 

MOVEFILE 

MOVE 

CLMINTRO 

00028 

PRINT 

pa 

CLHINTRO 

*0029 

PUNCH 

PU 

CLMINTRO 

00030 

QUERY 

Q 

CLMINTRO 

0 0031 

RENAME 

a 

CLMINTRO 

*0*32 

RELEASE 

DEL 

CLMINT RO 

*0*33 

READCABD 

READ 

CLMINTRO 

*0034 

SET 

S 

CLMINTRO 

00035 

SVCTRACB 

SVC 

CLMINTRO 

**036 

SYNONYM 

SYN 

CLMINTRO 

00037 

TYPE 

T 

CLMINTRO 

00038 

TXTLIE 

TXT 

CLHINTRO 

*0039 

UPDATE 

U 
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CLGLOSS 

00007 

21*233111 

CLGLOSS 

CLGLOSS 

CLGLOSS 

CLGLOSS 

00011 

00013 

00014 

o r>o 1 5 

For a more complete list of data processing terms, see the 
publication Data Processing.Glgssary. GC20-1699. Where a 
term has an asterisk (*) preceding the listed meaning, it is 
an Aaerican National Standard definition. 

CLGLOSS 

CLGLOSS 

CLGLOSS 

00017 

00018 

00020 

active disk table: A table residing in the user's coi^y ot 
the CHS nucleus that contains an entry for each of the CMS 
disks that can be accessed. 

CLGLOSS 

CLGLOSS 

CLGLOSS 

00021 

00022 

00024 

active file table: A table residing in the user's copy cf 
the CMS nucleus that contains an entry for each user file 
that is open. 

CLGLOSS 

00026 

active page: A page in real storage that can te addressed. 

CLGLOSS 

CLGLOSS 

CLGLOSS 

00028 

0028 

OH029 

address stop: A capability to specify at the svsten console 
an address which, when encountered, causes a halt in 
processing. 

CLGLOSS 

CLGLOSS 

CLGLOSS 

CLGLOSS 

00031 

00031 

00032 

0^033 

address translation: The process of changina the address of 
a data item or an instruction from its virtual address to 
its real storage address, See_also dynamic address 
translation. 

CLGLOSS 

CLGLOSS 

CLGLOSS 

00037 

00037 

nnp38 

alphameric characters: In software, usually the characters 
A through Z, digits 0 through 9, and the special characters 
#, $, and d. 

CLGLOSS 

CLGLOSS 

CLGLOSS 

00041 

00041 

00043 

attention interruption: An interruption cf instructicn 
execution caused by a terminal user pressing the attention 
key. See also simulated attention. 

CLGLOSS 

:LGL053 

00044 

00046 

attention key: A function key on seme termirais that causes 
an interruption of execution by the central [recessing unit. 

CLGLOSS 

CLGLOSS 

CLGLOSS 

00047 

00048 

00050 

available page queue: A queue of the paces wiicse real 
storage is currently available for allocaticn to any tasx. 
See,a Iso active page queue, hold page queue. 
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CLGLOSS 00051 
CLGLOSS *0*52 
CLGLOSS 00053 
CLGLOSS 00054 
CLGLOSS 00055 


basiq c ontr ol.node: A node in which the teatures cf an IBM 
System/360 computing system and additional Systein/37j 
features, such as new machine instructions, are operational 
on a System/370 computing system. See also extended control 
(EC) mode. 


CLGLOSS 00057 BC mode : Basic control mode. 


CLGLOSS 00059 

CLGLOSS 00060 
CLGLOSS *0*61 


change! pro gram translation; in a channel program, 
replacement by software of virtual addresses with real 
addresses. 


CLGLOSS 00063 

CLGLOSS 00064 
CLGLOSS *9065 


chapa cter -de l g^ion * character withic a line cf 

terminal input specifying that it and the insediately 
preceding character are to be renoved from tie line. 


CLGLOSS 00067 

CLGLOSS 00069 


CHS; Conversational Monitor System. 

CMS f unctio n: See CMS service routines. 


CLGLOSS 00070 
CLGLOSS 00071 
CLGLOSS 0*072 
CLGLOSS 00073 


CHS n ucleus : A portion of CMS tha]t 

user's virtual storage whenever CMS 
user receives a copy of the CMS nuc 
IPL of CHS. 


|is 

us 


le 


is resident in the 
executing. Each CMS 
wher he ferfcrms an 


CLGLOSS 00074 

CLGLOSS * 0075 
CLGLOSS 0OC76 
CLGLOSS *0077 


CMS p rimary disk : In VM/370, an ar 
storage device allocated to each CMS 
A-disk on which his stored files 
retained until he requests that they 


ea on a direct 
user or accesse 
and/or data £ 
be deleted. 


dCC€S3 

d as the 
ets are 


CLGLOSS 00078 

CLGLOSS 0 *079 
CLGLOSS *0081 


CMS s ervice routin es: Boutinas that 
internal processing, such as ad 
directories or performing disk or ter 


CMS ccmmands use for 
essing and updating 
ainal icput/cuput. 


dr 


CLGLOSS 09*82 
CLGLOSS C 3083 
CLGLOSS ***84 
CLGLOSS *0*86 


CMS s ystem disk: In VM/370, an a 

storage containing the CHS nucleus, 
portion of CMS, The CHS system disk 
S-disk in read-only node. 


rea 

and 

can 


on direct access 
tie disk-resident 
be accessed as tne 


CLGLOSS 09087 
CLGLOSS 00089 


CMS $41?* In VM/370, any CMS file residing cn the 

CMS system disk as opposed to the user's disks. 
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CLGLOSS 00090 CMS use r di sk: In VM/370, CHS disic acea allocated to eacn 
CLGLOSS 00092 user (at the time he is authorized J :o use the VM/37C system) 
CLGLOSS 00092 on whic.h stored files are retained until the user causes 
CLGLOSS 00094 them to be deleted. 


CLGLOSS 00095 cold start : (1) Usually synonymous with initial program 
CLGLOSS 00096 loader. (2) In VM/370, a system restart that ignores 

OLGLOSS 00098 previously initialized data areas. 


CLGLOSS 00099 comm a nd : (1) * A control signal. (2) * Lccsely, an 

CLGLOSS 00100 instruction in machine language< (3) * Locsely, a 

CLGLOSS f'OIOI mathematical or logic operator. (4) A request frcra a 

CLGLOSS 00102 terminal for the execution of a particular program, called a 

CLGLOSS 00103 command processor. (5) See_also operator ccmmand, channel 
CLGLOSS ^0104 command, subcommand. 


CLGLOSS 00105 comm a nd pri v ilege cl ass: In VM/370, classes assigned to a 
CLGLOSS 00106 VM/370 user that allow him to access logical subsets of the 
CLGLOSS 00107 VM/370 control program commands. 


CLGLOSS 00108 command processo r: A problem program executed as a result 

CLGLOSS O0110 of entering a command at the terminal. 


CLGLOSS 00112 comm a nd sca n: A service routine that checks the syntax cf 
CLGLOSS 00113 commands and subcommands. 


CLGLOSS 00115 cont e xt edi ting: In systems with time sharing, a iretncd cf 
CLGLOSS 00116 editing a line data set or file without usicg line numbers. 
CLGLOSS 00116 To refer to a particular line, all or part of the contents 
CLGLOSS 00118 of that line are specified. 


CLGLOSS 00120 cont£cl_terminai: In systems with time sharing, any active 
CLGLOSS 00121 terminal at which the user is authorized tc enter commands 
CLGLOSS 00122 affecting system operation. 


CLGLOSS 00124 Conv e rsatio n al Monitor System (£MS): A virtual machine 

CLGLOSS 00125 operating system that operates only under the control of the 

CLGLOSS 00126 VM/370 control program. 


CLGLOSS 00128 core table : See page table. 


CLGLOSS 00130 current lin e poin^e^;: (1) In systems with tine sharing, a 
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CLGLOSS 

CLGLOSS 

CLGLOSS 

CLGLOSS 


CLGLOSS 


CLGLOSS 

CLGLOSS 

CLGLOSS 

CLGLOSS 


CLGLOSS 

CLGLOSS 

CLGLOSS 

CLGLOSS 


CLGLOSS 

CLGLOSS 


CLGLOSS 

CLGLOSS 

CLGLOSS 


CLGLOSS 

CLGLOSS 

CLGLOSS 


CLGLOSS 

CLGLOSS 

CLGLOSS 

CLGLOSS 


CLGLOSS 


CLGLOSS 

CLGLOSS 

CLGLOSS 


CLGLOSS 

CLGLOSS 

CLGLOSS 

CLGLOSS 


00130 pointer that indicates the line of a line data set or file 
00131 with which the user is currently working. (2) In VM/370, a 
n 0132 pointer that indicates the recor'd number of a CMS file with 
00134 which the user is currently working. 


00136 £AX: Dynamic address translation. 


00138 dedicat ed c hanaejLop ti on: A VM/370 virtual machine option 
°0139 which improves performance of a virtual machine ty typassing 
00139 address translation of virtual devices and VM/37C control 
00141 program channel scheduling. 


00143 direc tory ; An index that is used by the ccrtrcl program tc 
00143 locate one or more blocks of data that are stored in 

00144 separate areas of a data set or files in direct access 
00145 storage. 


00146 dire c tory f ile: A VM/370 disk file that defines tne virtual 

00148 machine configuration of each user. 


00150 discon nect m oj g: In VM/370, the state of a virtual machine 
00151 that does not have a physical line or terminal ccDnected as 
00152 an operator console. 


00153 disp a tching : (1) The act of scheduling a tasic fcr 
00154 execution. (2) In VM/370, the starting of virtual machine 
00155 execution. 


00156 dynam ic add res s t r anslat ion (DAT): (1) The change of a 
00157 virtual storage address to a real storage address during 
00158 execution of an instruction. See_jl£o address translation. 
C0160 (2) A hardware feature that performs the translation. 


00162 £C mode: See extended control mode. 


00164 ed it mode : In systems with time sharing, an entry mode 
00165 under the EDIT command that accepts successive subcommands 
00166 suitable for modifying an existing line data set or file. 


00167 exte n ded co ntr ol (EC) mode : A mode in which all the 
00168 features or an IBM System/370 computing systei, including 
00169 dynamic address translation, are operational. jiS£_al££ basic 
00171 control (BC) node. 
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XBjj Vic tual .Machine facili,^y/370 ( VM/ 370) : A time-snaring 
System Control Program that consists of: (1) a control 
program that manages the resources of an IBM System/370 
computing system in such a way that multiple remote terminal 
users have a functional simulation of an IEK System/370 (a 
virtual machine) at their disposal and (2) the 
Conversational Monitor System. 

inpu t line : In VH/370, information typed fcj a user between 
the time the typing element of his terminal ccmes to rest— 
following a carriage return—until another carriage return 
is typed. 


inte r action : In systems with time sharing, a basic unit 
used to record system activity, consisting cf acceptance of 
a line of terminal input, processing cf the line, and a 
response, if any. An interaction is recorded when a user 
task starts its wait for a line of terminal input. 


interact ion time : In systems with time sharing, the time 
between requests for successive lines of teninal input. 


in teractive user : In VM/J70, a user (a virtual machine) is 
dynamically classed by the control program as interactive if 
he executes fewer than approximately 250,OCC instructions 
between terminal interrupts. 


job: O) * A specified group of tasks prescribed as a unit 
of work for a computer. By extension, a job usually includes 
all necessary programs, linkages, files, and instructions to 
the operating system. (2) In IBM Systes/36C operating 
systems, a collection of related problem programs, 
identified in the input stream by a JOB stateraert followed 
by one or more EXEC and DD statements. (3) In systems with 
time sharing, the processing done on behalf cr one user from 
logon to logoff. Synonymous with terminal job. 


line - deleti o n characte r: A terminal character tnat 
specifies that all characters are to be deleted from a 
logical line of terminal input. 


line, nu mber : A number associated with a line that can be 
used to refer to the line. 
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CLGLOSS 00215 
CLGLOSS 00216 
CLGLOSS 00217 
CLGLOSS 00218 


line pgaber edit ing: In systems with tine sharing, a node 
of operation under the EDIT command in which lines or 
records to be aodified are referred to by line cr record 
nuaber. 


CLGLOSS 00219 
CLGLOSS 00220 
CLGLOSS "0222 


A 

load aa p; A map containing the nain/real storage locations 
of control sections and entry points of a program loaded 
into nain/real storage. 


CLGLOSS 00223 
CLGLOSS 00224 
CLGLOSS 00225 
CLGLOSS 00226 
CLGLOSS 00227 
CLGLOSS 00229 


main storag e: (1) * The general purpose stcrage cf a 
computer. Usually, main storage can be accessed directly cy 
the operating registers. Contrasts with auxiliary storage. 
(2) All program-addressable storage frcm which irstructicns 
may be executed and from which data can be leaded directly 
into registers. See_aiso real storage and virtual storage. 


CLGLOSS 00231 


NCR: See aultiple control registers. 


CLGLOSS 00233 
CLGLOSS 00234 
CLGLOSS C 0235 
CLGLOSS 00236 


multi ple co ntrol registers (MC R); A set of registers used 
for operating system control of relocation, priority 
interruption, program event recording, error recovery, and 
masking operations. 


CLGLOSS 00238 
CLGLOSS 00238 
CLGLOSS 00239 
CLGLOSS 00240 
CLGLOSS "0241 
CLGLOSS 00243 


pu ll line : In Vfl/370, a terminal input line consisting of a 
carriage return or line-end character issued as the first 
and only information after the typing element of the 
terminal has come to rest following a previous carriage 
return or line-end character. Usually used tc terminate 
ASfiSi mode and enter EDIT mode. 


CLGLOSS 00245 
CLGLOSS 00246 
CLGLOSS 00247 
CLGLOSS 00248 


£age: (1) A fixed-length block of instructions, data, cr 
both, that can be transferred oetween real stcrage and 
external page storage. (2) To transfer instructions, data, 
or both between real storage and external pace stcrage. 


CLGLOSS 00250 page -in: The process of transferring a. page ficm external 
CLGLOSS 00251 page storage to real storage. 


CLGLOSS 00253 page number ; The part of a virtual storage address needed 
CLGLOSS 00254 to refer to a page. 


CLGLOSS 00256 
CLGLOSS 00257 


pa g e- out : The process of transferring a page frcm real 

storage to external page storage. 
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CLGLOSS 00259 2a<li.S3S The process of transferring pages between real 

CLGLOSS 00260 storage and external page storage. 


CLGLOSS 00262 pag i ng area ; In VH/370, an area in a direct access storage 
CLGLOSS 00263 device that is used by the control program fci the temporary 
CLGLOSS 00264 storage of pages when paging occurs. 


CLGLOSS 00266 pagi n g device : A direct access storage device on which 

CLGLOSS 00267 pages (and possibly other data) are stored. 


CLGLOSS 00269 pagi n g supe r viso r: A part of the supervisor that allocates 
CLGLOSS 00270 and releases real storage space (page frames) for pages, aDd 
CLGLOSS 00272 initiates page-in and page-out operations. 


CLGLOSS 00273 f>as§yo££: In systems with time sharing, a on£- to 
CLGLOSS 00274 eight-character symbol that the user may be reguirea to 
CLGLOSS 00275 supply at the time he logs on the system. The password is 
CLGLOSS 00276 confidential as opposed to user identification. Users can 
CLGLOSS 00278 also assign passwords to data sets or tiles. 


CLGLOSS 00281 pref e rred v i rtual mach ine: In Vfi/370, a generic name 
CLGLOSS 00282 describing a particular virtual macaine to which ere cr mere 
CLGLOSS 00284 of the performance options have been assigned. 


CLGLOSS 00285 prior it y: A virtual machine parameter that influences the 

CLGLOSS 00287 Internal scheduling algorithm of the VM/370 control program. 


CLGLOSS 00288 EE2i!EtiM : A function that helps a terminal user cy 

CLGLOSS 00289 reguesting him to supply operands necessary tc continue 

CLGLOSS 00290 processing. 


CLGLOSS 00292 real addres s: The address of a location in real storage. 


CLGLOSS 00294 re al storag e: The storage of System/370 from which the 
CLGLOSS 00295 central processing unit can directly obtain instructions and 
CLGLOSS 00296 data, and to which it can directly return results. See_also 
CLGLOSS n 0297 main storage. 


CLGLOSS 00300 reloc ate ha ca)aaE5* See dynamic address translation 
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CLGLOSS 


CLGLOSS 

CLGLOSS 
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CLGLOSS 

CLGLOSS 

CLGLOSS 

CLGLOSS 


CLGLOSS 

CLGLOSS 

CLGLOSS 


00302 resp o nse ti ne; (1) The tine between the sctmissicn of an 
00303 item - of work to a computing system and the return of 
00304 results. (2) In systems with time sharing, the tine between 
00305 the end of a block or line-end character of terminal input 
00306 and the display of the first character of system response at 
00308 the terminal. 


00310 segment: (1) A continuous 64K area of virtual storage. 
00311 that~is allocated to a job or system task. (2) In VM/370, a 
00312 segment can also be 1024K, 


00313 separator: (1) * See file separator, group separator, 

00314 information separator, record separator, unit separator. (2) 
00316 * Same as delimiter. 


00317 simu l ated at tentio n: A function that allows terminals 
n 0318 without attention keys to interrupt processing. The 
00319 terminal is queried periodically for a specified character 
00321 string. See_ai §2 attention interruption. 


00322 spoo l ing ar ea: Any direct access storage area temporarily 
00323 used by VM/370 to store input for a virtual card reader cr 
<00325 output from a virtual printer or punch. 


00327 stat i c CP a gea: Those portions of virtual storage that ate 
C0328 allocated,, during system generation and IPL, to the control 
00329 program functions. 


00331 stora ge b lock: A 2K block of real storage tc which a 

00332 storage key can be assigned. 


00334 Syste m rest art; The restart that allows reuse of {.revicusly 
^0334 initialized areas. System restart usually requires less 
r, 0336 time than IPL. Synonymous with warm start. 


00337 temp o rary d isk: In VM/370, an area on a direct access 
°0338 storage device allocated to the user at logon time cn whicn 
n 0339 his stored files and/or data sets are retained until he logs 
00340 off. 


00341 termiaa l_I/9 .^ait: The condition of a task that car.nct 

00342 continue processing until a message Is received from a 
00343 terminal. 


427 



IBM CONFIDENTIAL 


CLGLOSS 


CLGLOSS 

CLGLOSS 


CLGLOSS 

CLGLOSS 

CLGLOSS 

CLGLOSS 


CLGLOSS 

CLGLOSS 


CLGLOSS 

CLGLOSS 

CLGLOSS 

CLGLOSS 

CLGLOSS 


CLGLOSS 

CLGLOSS 

CLGLOSS 

CLGLOSS 

CLGLOSS 

CLGLOSS 

CLGLOSS 


CLGLOSS 

CLGLOSS 

CLGLOSS 

CLGLOSS 

CLGLOSS 

CLGLOSS 


CLGLOSS 


CLGLOSS 

CLGLOSS 


CLGLOSS 

CLGLOSS 
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00345 term i nal lo b: Sea job (3) . 


00347 termi nal us er; In systems with time-sharing, anyone who is 
00348 eligible to log on. 


00350 t ext li brar y: In 7M/370, a CMS user or system tile that 
00351 contains relocatable object modules and a directory 
00352 indicating the location of each of these nodules within the 
00353 library. 

00355 time share : To use a device for two or »cte interleaved 
00356 purposes. 


00358 time sharin g: (1) * Pertaining to the interleaved use cf 

00359 the time of a device. (2) A method of using a computing 

00360 system that allows a number of users to execute programs 

00361 concurrently and to interact with the [tograms during 

00362 execution. 


00364 time slice : (1) A uniform interval of time on the central 
00365 processing unit allocated for use in performing a task. Cnee 
^0366 the interval has expired, CPU time is allocated tc aiicthec 
C0367 task; thus, a task cannot monopoli 2 e CPU time Leycud a 
00368 fixed limit. (2) In systems with time sharing, a segment cf 
00369 time allocated to a terminal job. S ee a lso major tine slice, 
00370 minor time slice. 


00372 time sli cin g: (1) An optional feature of the MFT and MVT 
00373 control program configurations that can be used to prevent a 
00374 task from monopolizing the central processing unit and, 
00375 thereby, delaying the assignment of CPU time to ether tasks. 
00376 (2) In systems with time sharing, the allocation of time 
00377 slices to terminal jobs. 


00380 user disk : See CMS user disk. 


00382 user id enti fica tio n; A one- to eight character symbol 
00383 identifying each system user. Abbreviated ISOLD. 


00384 user profile tab le: In systems with time sharing, a table 
°0385 of user attributes kept for each active user, built trem 
n 0386 information gathered during the logon. 
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CLGLOSS 
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veri f icatio n mod e: In systems with tine-sharing, a mode cf 
operation under the EDIT command in which all subcommands 
are acknowledged and any textual changes are displayed as 
they are Bade, 

virt ual.a ddres s; An address that refers tc virtual storage 
and aust, therefore, be translated into a real storage 
address when it is used. 


virtu a l coa p utinq syst em: Same as virtual nachine. 


VH/37 0, t he time required tc execute 
only the instructions of the virtual machine. 


virt u al equals rea l_LV;ifiL_storage: An area of virtual 

storage that has the sane range or address as real storage 
and is used for a program or, in OS/VS, part cf a program 
that cannot be paged during execution. 


virt u al mac hine: A functional simulaticr cf an IBM 
System/370 computing system. Each virtual machine usually is 
controlled by a suitable operating system. VM/37C controls 
the concurrent execution of multiple virtual machines. 


virt u al = real optio n: In VM/370, a virtual machine option 
that permits the entire storage of a virtual machine to have 
the same range of addresses as real storage, except page 
zero which must be relocated. It is used for programs that 
dynamically modify channel programs and for performance 
gains. 


virt u al storag e: (1) Addressable space that appears to tne 
user as real storage, from which instructions and data are 
mapped into real storage locations. The size cf virtual 
storage is liaited by the addressing scheme cf the computing 
system and Dy the amount of auxiliary storage available, 
rather than by the actual number of real storage locations. 
(2) Addressable space that appears to the user as real 
storage, froa which instructions and data are sapped into 
real storage Locations. The size of the virtual storage is 
liaited be the addressing scheme of the virtual xachine ar.d 
the aggregated aaount of external page storage available. 


VH/3 7C: IBM Virtual Nachine Facility/370, 
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CLGLOSS 00*31 
CLGLOS5 00432 
CLGLOSS 00433 
CLGLOSS 00434 
CLGLOSS 00434 
CLGLOSS 00435 
CLGLOSS 00436 


VM/3 7 0 cons o le functio n; A facility that allows the 
terminal user to simulate the functions available at a CEl) 
operator's console of the real machine. The command 
facilities of the VM/370 control program (excluding its 
subsystem CMS) are referred to collectively as VM/370 
commands and the ones which affect simulation are rexerred 
to as console functions. 


CLGLOSS 00438 
CLGLOSS 00439 
CLGLOSS 00440 


warn start; (1) Same as system restart. (2) The automatic 
reinitialization of the VM/370 control program that occurs 
if the control program can not continue processing. 



